Wikilinks & Backlinks

Link notes together with wikilinks and discover connections with backlinks.

Wikilink Syntax

Link between notes using double-bracket syntax:

  • [[Note Name]] links to a note by name
  • [[Note Name#Heading]] links to a specific heading within a note
  • [[Note Name|Display Text]] links with custom display text
  • ![[image.png]] embeds an image via wikilink

Autocomplete

Type [[ to open the wikilink autocomplete popover. It fuzzy-searches your notes as you type, showing the note name and relative path. After typing #, it shows headings from the target note for deep linking.

If the note you're linking to doesn't exist yet, select the "Create" option to create it. Clicking any wikilink to a non-existent note also creates it automatically.

Resolution

mdnb resolves wikilinks by both path ([[folder/note]]) and basename ([[note]]). When multiple notes share the same name, mdnb disambiguates by preferring the most recently modified note or the one closest to the root.

Rename Propagation

When you rename a note, mdnb automatically updates every wikilink pointing to it across your entire vault. Heading anchors and display text aliases are preserved.

Backlinks Panel

Press Cmd+Shift+B to open the backlinks panel on the right side of the editor. It shows every note that links to the one you're currently viewing. Click any backlink to navigate to the linking note.

Unlinked Mentions

Below the backlinks list, an expandable "Unlinked Mentions" section shows paragraphs from other notes that mention the current note's name as plain text (without a wikilink). Click the Link button next to any mention to convert it into a proper wikilink automatically.