Images Not Loading

Symptom

Images in your Markdown document show as broken or empty placeholders.

Common causes

1. Sandbox folder access not granted

macOS sandboxing restricts which folders Markant can read. If your images are in a different directory than the .md file, Markant needs permission.

Fix: When Markant asks for folder access, select the parent folder that contains both the .md file and the images. For Obsidian vaults, select the vault root.

2. Incorrect image path

Image paths in Markdown are relative to the file. A common mistake:

<!-- This works if the image is next to the .md file -->
![](diagram.png)

<!-- This works if there's an images/ folder next to the .md file -->
![](images/diagram.png)

<!-- This WON'T work — absolute paths break portability -->
![](/Users/you/Documents/diagram.png)

Fix: Use relative paths. For MarkBooks, place images in assets/ and reference them as ![](assets/image.png).

3. Remote images without network

If a document references a remote URL (![](https://example.com/image.png)), the image requires an internet connection.

Fix: Ensure you have network access, or use local images instead.

Still not working?

Contact [email protected] with the document and a description of the issue.