If images in your Markdown or AsciiDoc files aren’t rendering, it’s often due to the use of relative paths that can’t be resolved in the current context.
To ensure images are rendered correctly:
-
Use absolute paths relative to the repository root when possible.
-
Make sure the image file exists and is accessible at the specified path.
AsciiDoc
=== Picture 1 Block
image::/images/Example.png[]
=== Picture 2 Inline
image:/images/Example.png[]
Markdown
