Configuration
Settings, tools, and project configuration for AsciiDoc Pro.
Main settings#
Open Settings → Tools → AsciiDoc Pro for preview, diagrams, editor options, attributes, and export tools. Under Project settings, configure the Antora playbook, documentation root, and additional include directories.
Paths and includes#
Project-setting relative paths start at the IDE project root. Use . for that root, select files/folders with the picker, and do not add shell quotes around paths with spaces. Includes first resolve relative to the including document, then through configured fallback directories in order. Images use imagesdir or the document directory.
Attributes and safe mode#
Custom attributes accept comma-separated key=value pairs or one pair per line. Application attributes and project Antora attributes are configured separately. The selected safe mode governs file access; Secure mode prevents include reads. Project JavaScript extensions load only in trusted projects.
Export executables#
In the main page’s Export section, select the executable itself for Pandoc, Asciidoctor, or asciidoctor-pdf. Explicit paths are absolute; an empty path enables automatic discovery. Choosing a path does not install the tool.
Manual for version 2026.2.19 · Reviewed