Troubleshooting

An include is not rendered#

Check the path relative to the including document, fallback include directories, and safe mode. Secure mode blocks file reads. Nested includes resolve from the nested document, not always the first source file.

An image resolves in one view but not another#

Check imagesdir, source-directory paths, and export configuration. Include search directories do not redefine image resolution.

An export tool is missing#

Choose an installed executable under Tools → AsciiDoc Pro → Export. Test the converter from a terminal and review the export error for timeout, cancellation, or missing dependencies.

Report an issue#

Use email support and include:

• Your IDE edition and full build number from Help → About.
• The installed plugin version; this manual covers 2026.2.19.
• Relevant external-tool versions, the failing action, and a small reproducible example.
• The error message and relevant log excerpt, with credentials and private project data removed.

Use Help → Show Log in Finder/Explorer to locate IDE logs when requested. Describe what you expected to happen and whether the same operation works from a terminal.