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.

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.

Mac App Store macOS 15.6 or later
Ubuntu — PPA Ubuntu 24.04 or later

Get MarkdownMate

Mac

Free on the Mac App Store

macOS 15.6 or later

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.