Obsidian vault
Open an Obsidian vault on Mac and Ubuntu.
An Obsidian vault is a folder of Markdown files, so MarkdownMate opens it like any folder of notes. This page lists what works there and what doesn't, in the versions it describes: MarkdownMate 4.4 for Mac and 0.11.0 for Ubuntu. MarkdownMate is not made by or affiliated with Obsidian.
Open the vault as a folder
Choose File ▸ Open Folder… (⇧⌘O) on Mac, or Open… on Ubuntu, and pick the vault's folder. The sidebar shows its notes and subfolders. Nothing is converted or imported: your notes stay .md files where they are.
Wiki links, heading links and aliases
See [[Project Plan]], [[Project Plan|the plan]]
and [[Project Plan#Budget]].
[[Note]], [[Note|shown text]] and [[Note#Heading]] link to notes in the open folder by name, and typing [[ lists the notes to pick from. A note's other names under aliases: in its front matter work as link targets too. Backlinks, Unlinked Mentions and renames know about them, and Open Quickly finds a note by its alias, listed as “Alias → Note”. Rename Heading… (right-click a heading in the Outline) updates every [[Note#Heading]] link to it. See wiki links and backlinks.
Block references
Ship the beta in March. ^beta
See [[Project Plan#^beta]].
A ^id at the end of a paragraph, list item, quote or table, or alone on its own line after one blank line below a list, table, quote or code block, names that block and is hidden in the preview and exports. [[Note#^id]] and [[#^id]] open the note at that block, typing #^ after a note name suggests its blocks, and Find Broken Links lists links to a block that no longer exists.
Embeds
![[photo.png|300]]
![[Project Plan#Budget]]
![[Project Plan#^beta]]
![[image.png]] shows the image (|300 sets its width, |300x200 both), and ![[Note]], ![[Note#Heading]] or ![[Note#^id]] shows that note, section or block in place, in the preview and exports. Embeds go one level deep: an embed inside an embedded note shows as a link. Markdown images take Obsidian's sizes too: .
Tags, inline and in front matter
#tag and nested #work/project show up in the sidebar's Tags tree, and so do tags: in the front matter (a list in brackets, a block list, or comma-separated). Rename Tag… changes a tag in every note of the folder. See tags in Markdown notes.
YAML front matter
The --- block at the top of a note is shown in the preview as a properties table, one row per key, with lists like tags: [a, b] as “a, b”. A setting switches it to Table, Source or Hidden (Settings ▸ Preview on Mac, Preferences ▸ Preview on Ubuntu). It stays in the file as you wrote it.
Templates and daily notes
New from Template lists the notes in the Templates folder of the vault. Placeholders are {{date}}, {{time}}, {{title}} and {{cursor}}, and {{date:FORMAT}} or {{time:FORMAT}} take Obsidian-style tokens such as {{date:dddd, MMMM D, YYYY}}. Today's Note opens the day's note in the daily notes folder, starting from Template.md on its first use each day. The daily note name setting takes the vault's format, such as YYYY/MM/YYYY-MM-DD for Daily/2026/11/2026-11-02.md or YYYY-MM-DD dddd; Daily Note for Date… opens any day from a calendar. See templates and daily notes.
Backlinks and vault checks
The Outline shows Backlinks and Unlinked Mentions for the current note. Find Broken Links… lists links that reach no note, and Find Open Tasks… lists every unchecked - [ ] task in the folder. Find Unused Attachments… lists files in assets folders and the attachments folder that no note uses. All three are in both apps.
Attachments folder
The attachments folder setting (Settings ▸ General ▸ Folders on Mac, Preferences ▸ Notes on Ubuntu) says where pasted and dropped images go. Start it with /, as in /attachments, for a folder at the top of the vault, as Obsidian vaults keep them. Pasted screenshots can be saved as PNG or JPEG and scaled down to 1200, 1600 or 2000 pixels wide.
Markdown your notes already use
GitHub task lists, footnotes, $math$, Mermaid diagrams, ==highlights== and GitHub alerts such as > [!NOTE] render in the preview and exports. So do Obsidian's callout kinds (> [!info], [!tldr], [!question], [!example], [!quote] and the rest) with your own title, and folded callouts: > [!tip]- starts closed, > [!tip]+ open, and clicking the title toggles it. %%comments%% are hidden in the preview and exports and stay in your note. See the Markdown syntax guide.
What does not work
- Community plugins, including Canvas files, Graph view, Dataview-style queries and other plugin syntax. MarkdownMate has no plugin system.
- Obsidian Sync and Obsidian Publish. MarkdownMate doesn't sync; use iCloud, Git or any service that syncs folders. Export Folder as HTML… turns a folder into web pages.
- Obsidian's settings. The app doesn't read your Obsidian configuration.
Get MarkdownMate
Free on the Mac App Store and the Ubuntu PPA. No account, no subscription.
Get MarkdownMate
Ubuntu
sudo add-apt-repository ppa:homielab/markdownmate
sudo apt update
sudo apt install markdownmate
Ubuntu 24.04 or later (amd64)
No account, no cloud: notes stay as .md files on your disk.