Skip to content

Linking & references ​

Aurora is built around connections between ideas. Links, block references, backlinks and unlinked mentions work together to build your knowledge graph.

Shortcuts on this page are shown for macOS. On Windows and Linux, use Ctrl instead of ⌘.

Type [[ and start typing a page name. A picker shows matching pages; select one to insert a link. You can also type @ to link to a page or mention a workspace member.

Hover over a page link to see a preview card. Click a link to open the page, or:

  • ⌘-click to open it in a peek window without leaving your page
  • ⇧-click to open it in a popup
  • ⌘⇧-click to open it in split view

Block references ​

Every block in Aurora has a unique ID, so you can reference a single block from anywhere:

  1. Right-click the block and choose Copy block reference.
  2. Paste it into any other page.
  3. The referenced block's content renders inline and updates when the source changes. To open the source, hover the reference and click the Go to source button at its right edge. On touch screens the button is always visible.

Every page shows a Backlinks section listing the pages that link to it. Backlinks are automatic: link from page A to page B, and page B shows page A in its backlinks. You can also add a Backlinks widget to the right panel.

Unlinked mentions ​

Below the backlinks, Unlinked mentions lists places where the page's title appears as plain text without a link. Click Link next to a mention to turn it into a real link.

Graph view ​

Open the graph view from the sidebar or press ⌘⇧G to see your workspace as a graph. Nodes are pages and edges are links. Click a node to open that page. See Knowledge tools.

Embedding and including pages ​

Type /embed and choose Embed page to show another page's content inside the current one. Type /include and choose Include page to show another page live and read-only: the whole page, a single block, or one heading section. Both update when the source page changes.

Aurora is in public beta and free while beta.