Skip to content
Orbit Orbit Orbit Docs

Link pages with wiki links

Connect pages into a wiki: type [[, pick a page, done — and Orbit keeps the links correct when pages are renamed.

Link to another page

Section titled “Link to another page”
  1. Type [[ anywhere in a page.
  2. The Link to page picker opens — keep typing to search page titles.
  3. Press Enter to insert (Enter to insert).

The slash menu offers the same thing as Link to page (“Link to another page”), and Subpage creates a new page inside this one and links to it in one step. Hover any wiki link to preview the target page in a popover; click it to open the page.

Embed a page or drawing

Section titled “Embed a page or drawing”

Type ![[ instead to embed rather than link:

  • Live page shows the target page inside the current one and keeps it up to date; add #Heading to show one section. See Live pages.
  • Embed drawing renders an Excalidraw canvas — see Drawings.

Both are also in the slash menu. An embed whose target is missing shows “This page target does not resolve in the current workspace index.”

The wiki-link picker open mid-sentence with matching pages and the Enter to insert hint
Section titled “Rename without breaking links”

When you rename a page, Orbit rewrites every [[link]] pointing at it across the workspace — including in pages other people have open, which update live. A toast confirms the sweep: “Updated N wiki links — References to “{old}” now point to “{new}”.” Rewriting inbound links requires edit access; if any referencing page fails to update, Orbit tells you: “Some wiki links could not be updated”.

Section titled “Handle unresolved links”

A wiki link whose target does not exist is unresolved:

  • The knowledge sidebar lists them under Unresolved links — see See backlinks and the graph.
  • Clicking one shows Linked file not found (“No workspace file matches [[{target}]].”).
  • If several files match a link, Orbit shows Multiple files match this link — add a folder path inside the link to disambiguate.

FAQ

Section titled “FAQ”

Do wiki links survive outside Orbit? Yes — they are plain [[target]] text in the markdown file, readable in any editor.

What keeps the link index fresh? Orbit indexes links as you edit. After bulk imports or renames outside Orbit, run Rebuild link index from the command palette (“Rescan workspace pages for wiki links”).

Up next: see what links back to each page in See backlinks and the graph.