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.
Write links
Section titled “Write links”| 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 links
Section titled “Click links”- 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.
Backlinks and outgoing links
Section titled “Backlinks and outgoing links”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.