Wiki links
Wiki links and backlinks in plain Markdown files.
Link one note to another with [[Note]], see which notes
link back, and keep every link as ordinary text in your own Markdown
files. MarkdownMate does it on Mac and Ubuntu, with no account and no
database. Coming from an Obsidian vault? See
what works.
Write a wiki link
Met with the team about [[Project Plan]].
Budget questions are in [[Project Plan|the plan]].
Put a note's name between double brackets to link to it, inside the folder you have open. Add |text to show other words in the preview. Type [[ and MarkdownMate lists the notes in the folder; keep typing to narrow the list and pick one.
A link to a note that doesn't exist yet is shown dimmed on Mac and in red on Ubuntu. Click it, and MarkdownMate creates the note and opens it, so you can write the link first and the note later.
Link to a heading
See [[Project Plan#Budget]].
Back to [[#Open questions]] in this note.
[[Note#Heading]] opens the other note right at that heading, and [[#Heading]] jumps to a heading in the same note. Type # after [[Note, or [[#, to pick from the note's headings. The Outline can also copy a link to any heading.
Link to a block
Ship the beta in March. ^beta
See [[Project Plan#^beta]].
Links can point at one block of a note — a paragraph, a list item, a quote or a table — not only at its headings. A ^id at the end of the block names it, hidden from the preview, or write [[Note#^ and pick from the ids MarkdownMate knows.
Copy Link to Block does it without typing: put the cursor in the block and right-click, or choose Edit ▸ Copy Link to Block on Mac (main menu ▸ Edit on Ubuntu). A block that has no id yet gets one, as one undo step, and the [[Note#^id]] link is ready to paste.
Follow a link and come back
In the editor, ⌘-click a link on Mac or Ctrl+click it on Ubuntu. In the preview, just click it. The note opens wherever it is in the folder, at its heading if the link names one.
Go back to the note you came from with Back, and forward again with Forward: ⌘[ and ⌘] on Mac, Alt+Left and Alt+Right on Ubuntu. Each window keeps its own history.
A link is plain text in your file
MarkdownMate saves exactly what you typed: [[Project Plan#Budget]] stays in the .md file as those characters. There is no hidden ID and no database, so your notes open in any text editor, sync with any service and keep working in other apps that understand [[wiki links]]. A link finds a note by its file name, without the .md.
Backlinks
Open the Outline (⌥⌘O on Mac, Alt+Ctrl+O on Ubuntu). Under the note's headings, Backlinks lists every note in the folder that links to the current one, by wiki link or by relative Markdown link. Click one to open it. The list stays quick in large folders: with 10,000 notes it fills in milliseconds.
Unlinked Mentions
Unlinked Mentions, below Backlinks, lists the notes that name the current note without linking to it, as a whole word in any case. Click one to open it at the mention, or click its Link button to turn the mention into a wiki link in one step. Undo works in open notes.
Links follow a rename or move
Rename a note or move it to another folder in the sidebar, and MarkdownMate offers to update the wiki links, relative links and images that point to it in your other notes. Undo works in open notes. A moved note's own relative links keep working too.
Copy Wiki Link and notes with the same name
Right-click a note in the sidebar ▸ Copy Wiki Link to put [[Name]] on the clipboard. When two notes in the folder share a name, it copies [[Folder/Name]] instead, and you can write that form yourself to pick the right one.
Preview a link without opening it
Rest the pointer on a [[wiki link]] in the editor to see the linked note's first lines, starting at the heading for [[Note#Heading]]. On Ubuntu the tooltip shows the note's name and up to 12 lines as plain Markdown.
In the preview, footnotes read the same way: rest the pointer on a footnote number and its text appears in a small box beside it, without jumping to the end of the note. A click still jumps there.
Aliases: other names for a note
---
aliases: [MN, Meeting notes]
---
List a note's other names under aliases: in its front matter, and [[MN]] or [[Meeting notes#Agenda]] reach it, in the editor, the preview, Backlinks, Unlinked Mentions and Export Folder as HTML. [[ completion offers them too. A note actually named like the alias still wins.
Make links by dropping or splitting
Drop a note from the sidebar or your file manager into the editor to insert a [[wiki link]] to it ([[Folder/Name]] when another note has the same name). Other files insert a relative link.
Select text and choose New Note from Selection… (⌥⇧⌘N on Mac, Shift+Ctrl+Alt+N on Ubuntu) to move it into a new note and leave a [[link]] to it in its place. Undo brings the text back.
Find broken links
Find Broken Links… (Edit ▸ Find on Mac, the main menu on Ubuntu) lists every wiki link in the folder that reaches no note or alias, and every relative link or image whose file is missing, for example after a rename outside the app. Each row opens the note at that line. Find in “Name”… in a folder's right-click menu searches only that folder.
Export Folder as HTML… turns the whole folder into web pages, with wiki links pointing at the linked pages. See export a folder as HTML.
Mac and Ubuntu
Both apps read and write the same links, so one folder works on both. The differences are the keys:
- Open a link in the editor: ⌘-click on Mac, Ctrl+click on Ubuntu.
- Outline, Backlinks and Unlinked Mentions: ⌥⌘O on Mac, Alt+Ctrl+O on Ubuntu.
- Back and Forward: ⌘[ / ⌘] on Mac, Alt+Left / Alt+Right on Ubuntu.
More about tags, daily notes and templates is on notes in Markdown; every shortcut is on keyboard shortcuts.
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.