Skip to content

Linked Notes

James Merrix edited this page Jul 22, 2026 · 1 revision

Linked notes

Open a folder (⌘⇧O) and Markappoly indexes every Markdown file in it: which notes link where, and which tags appear. That index powers everything on this page. If your notes came out of Obsidian, they work as they are.

Wiki links

Write [[Note name]] and it becomes a link to the note with that file name, wherever it sits in the folder. Matching ignores case and the file extension. A few variations:

  • [[Note name|shown text]] displays your own text instead of the name.
  • [[Note name#Heading]] links to a heading in another note.
  • [[#Heading]] jumps to a heading in the current document.
  • Two files with the same name? Qualify with the folder: [[projects/Note name]].

Links to notes that don't exist yet render dimmed, with a dashed underline.

Backlinks

The sidebar's Backlinks section lists every note that links to the one you're reading, along with the line each link sits on. Click an entry to open that note at that line. Ordinary relative links like [x](./x.md) count too, not just wiki links.

Embedding notes

![[Note name]] pulls another note's content into the preview, in a framed block with the note's name at the top. Click the name to open the real thing. ![[Note name#Heading]] embeds only that section, and ![[image.png]] embeds an image. Nesting stops after a few levels, so two notes that embed each other won't recurse forever.

Hover previews

Rest the pointer on an internal link for a moment and a small rendered preview of the target appears. Move onto the card to scroll it, or click its title to open the note in a tab.

Tags

#like-this in the text, or tags: in frontmatter, render as clickable chips. Click one and the sidebar searches the folder for it. Plain numbers like #123 are left alone, so issue references survive.

Quick switcher

⌘P opens the quick switcher. Type a few letters of a file name, pick a match with the arrow keys, press Enter. Two prefixes change what it searches: > lists commands (everything in the menus), and # lists the folder's tags. Bookmarked files float to the top.

Local graph

⌘⇧G draws the current note in the middle, with every note it links to and every note that links back arranged around it. Lines between the outer notes show their own connections. Click a node to open that note; the graph re-centres on it.

Bookmarks

Press ⌘D, or the star in the top bar, to bookmark the current file. Bookmarked files get their own section at the top of the sidebar and rank higher in the quick switcher. Press ⌘D again to remove the bookmark.

Clone this wiki locally