Nested include:: directives can fail to render in Confluence when paths cannot be resolved or unsupported AsciiDoc features are used.
Common causes
-
Unsupported path variables used inside
include::directives
Supported behavior
To ensure included files are rendered correctly:
-
Use relative or repository-root absolute paths for all
include::directives.include::docs/architecture/overview.adoc[] -
Verify the file exists and is accessible at the specified path in the repository.