Obsidian Vault Compatibility

Markant can open and navigate Obsidian vaults as a read-only viewer.

What works

• Wikilinks — [[page]] and [[page|display text]] resolve to other files in the vault
• Image embeds — ![[image.png]] renders inline
• Vault navigation — click a wikilink to navigate to that note, use ⌘[ to go back
• YAML frontmatter — displayed in the inspector panel (⌥⌘I)
• Sidebar — shows table of contents from headings

How to use

1. Open any .md file from your Obsidian vault
2. Markant may request folder access — grant it so images and linked files can be found
3. Navigate between notes using wikilinks or the sidebar

Folder access

Obsidian vaults store images in a separate directory (often assets/ or attachments/). Because macOS sandboxing restricts file access, Markant may ask for permission to read the vault folder.

When prompted, select the vault root folder to grant access to all files within it. This permission is remembered until you revoke it in System Settings > Privacy & Security.

Limitations

Markant is a Markdown viewer, not an Obsidian replacement. The following are not supported:

• Obsidian plugins (dataview, templater, etc.)
• Canvas files
• Callouts (rendered as standard blockquotes)
• Block references (^block-id)
• Tags as navigation elements (displayed as plain text)

Tip

Use ⌘⇧E to open the current file in Obsidian for editing, then switch back to Markant for reading.