Creating HTML and PDF

Create HTML and PDF from an AsciiDoc file directly from your IDE.

Creating a HTML file

The user can choose Create HTML from current file from the editor’s action toolbar to convert the file to HTML format. If creating HTML succeeds, the exported file is opened in the system’s default browser.

Creating a PDF file

The user can choose Create PDF from current file from the editor’s action toolbar to convert the file in the current AsciiDoc editor to a PDF using AsciiDoctor PDF version 1.5.x. If creating the PDF succeeds, the PDF is opened in the system’s PDF viewer. To find out more how to configure the output and formatting, please visit https://asciidoctor.org/docs/asciidoctor-pdf/.

Downloading Asciidoctor PDF support

As of AsciiDoc Plugin version 0.31.14+ Asciidoctor PDF is no longer included in the plugin as default as it adds approximately 2 MB to the download of the installation and each update.

When creating a PDF for the first time, the plugin will download the necessary dependency.

The download requires a working internet connection. When the download fails the IDE prompts to check proxy settings or to retry the download. The IDE’s event log contains instructions for a manual download of the file.

The dependencies will be cached locally. A new download will only be necessary when the AsciiDoc plugin requires a newer version.

Users can force the download by selecting “Download AsciiDoc dependencies for diagrams and PDF creation” in the settings of the plugin.