Linking Documents

Outerline for Mac supports wiki-style internal links, deep links to specific locations, folder links, and standard external links. All link types are surfaced in the Links panel (⌥+⌘+L).

Wiki Links

Type @ or [[ while editing to open the link picker. Start typing a note title, pick a result, and Outerline inserts [[Document Name]]. Legacy [@Document Name] links are still recognized. Wiki links connect your notes to each other — backlinks are tracked automatically, so any document that references another will appear in that document’s Links panel.

Deep Links

Deep links use the outerline:// scheme to point to a specific document or location. They work across apps — paste one into a terminal, another note, or a task manager and it will open Outerline directly to the right place.

Document

Opens a document by its stable UUID:

outerline://open/<UUID>

Heading

Jumps to a specific heading within a document:

outerline://open/<UUID>?heading=Overview

Line

Jumps to a specific line number:

outerline://open/<UUID>?line=5

Annotation

Jumps to a specific annotation:

outerline://open/<UUID>?annotation=<annotation-UUID>

Folder

Opens and selects a folder in the sidebar:

outerline://folder/<folder-UUID>

Path

Opens a document by its relative path within your library:

outerline://path/Notes/Planning.md

Shared Document

Imports a public Outerline share into your local library as a new Markdown document:

outerline://import-share?url=https%3A%2F%2Fs.outerline.so%2F<slug>%2F

Copying Deep Links

Right-click a heading, annotation, or line number gutter to copy a deep link to that location. You can also copy a document’s deep link from the document menu.

External Links

Use standard markdown syntax for websites:

[Outerline](https://outerline.so)

Pasting a URL while text is selected will automatically wrap it as a markdown link. External links also appear in the Links panel alongside internal ones.