Links and backlinks

In Markdown, type [[ and the files in the current Workspace pop up for you to choose from, making a wikilink; click it to jump to that file. The other way round, open a file, and in Info in the Inspector on the right, Backlinks lists the files that link to it and Outgoing lists the files it links to. Links work within a Workspace; files in a Temporary Location have no backlinks.

Syntax Links to
[[file name]] This file in the Workspace; .md can be left out
[[file name|display text]] The same, showing the text after the bar
[[file name#heading]] A heading in that file
[[#heading]] A heading in the current file
[[file name#^block-id]] The paragraph marked ^block-id in that file
[text](relative-path.md) An ordinary Markdown link; it works the same way and can include #heading
![[image.png]] Shows the image in the text
  • After [[, keep typing to narrow the suggestions; aliases written in frontmatter (aliases) are found too.
  • Targets are looked up in order: by path, then by file name, then by alias. When several files share a name, include the folder ([[folder/file name]]) to get the right one.
  • A wikilink whose target can't be found is shown as broken.
  • Click opens the link in the current tab, ⌘-click in a new tab, and ⌥⌘-click in a new window.
  • Hover over a link to see where it goes.
  • Right-click for Open Link, Open in New Tab and Copy Link.
  • Web addresses open in your default browser; if the linked file doesn't exist, you only hear an alert sound.
  • Links to files Resomark doesn't open, such as images, are handed to the system.
  • To edit a link's text, move the cursor into the link with the arrow keys and the source appears.

Open a file and click Info on the right of the toolbar, or press ⌥⌘I, and look in Details:

  • Backlinks: files in the Workspace that link to this one, at the top;
  • Outgoing: files this one links to, below.

Hover over an entry to preview that file; click it to open it. Only files in a Workspace have these two lists; files in a Temporary Location and new documents that haven't been saved don't show them.