UnmarkdownDocs

Wikilinks

Connect documents with [[wikilinks]]. Link ideas across your workspace and build a personal knowledge graph.

Wikilinks let you create connections between your documents using a simple bracket syntax. Type [[Document Title]] in any document to create a clickable link to another document in your workspace. This is the same syntax used by Obsidian, Notion, and other knowledge management tools.

Wikilinks are available on both the Free and Pro plans.

Basic Syntax

Wrap a document title in double square brackets to create a wikilink:

markdown
See my [[Project Roadmap]] for the full plan.

This relates to the [[API Design Notes]] we discussed.

The text inside the brackets must match the title of an existing document in your workspace. Matching is case-insensitive.

Display Text

Use a pipe character to show different text than the document title:

markdown
See the [[Project Roadmap|roadmap]] for details.

Read the [[API Design Notes|API notes]] first.

In the examples above, the links point to "Project Roadmap" and "API Design Notes" but display as "roadmap" and "API notes" respectively.

Autocomplete

When you type [[ in the markdown editor, an autocomplete dropdown appears with all your documents. The list filters as you type, using fuzzy matching to find documents even with partial or misspelled titles.

  • Start typing after [[ to filter by title
  • Folder paths are shown next to each title for disambiguation
  • Press Enter or click to insert the selected document
  • Press Escape to dismiss the autocomplete

You can also insert a wikilink from the toolbar by clicking the link icon (FileSymlink) and selecting a document.

Rename Propagation

When you rename a document, all wikilinks pointing to it across your entire workspace are automatically updated. This means you never have to manually fix broken links after renaming.

Rename propagation happens once when you finish editing the title (on blur), not on every keystroke. Documents that contain updated wikilinks are saved immediately.

Tip
Rename propagation works for both the sidebar rename (right-click, Rename) and the title field in the top bar.

The Related tab in the right panel shows all documents that link to the current document. This lets you see incoming connections and navigate your knowledge graph in reverse.

See Right Panel for more details.

Published Pages

When you publish a document, wikilinks are resolved based on the target document's visibility:

  • Public documents: the wikilink becomes a clickable link to the published page
  • Private or unpublished documents: the wikilink renders as plain text (no link, no special styling)
markdown
<!-- If "API Guide" is published as public -->
See the [[API Guide]] for details.
<!-- Renders as: See the <a href="/u/you/api-guide">API Guide</a> for details. -->

<!-- If "Draft Notes" is not published -->
See my [[Draft Notes]] for context.
<!-- Renders as: See my Draft Notes for context. -->
Note
Only documents with visibility set to "public" resolve as links on published pages. Documents shared via "anyone with the link" do not resolve, because their URLs are not meant to be discoverable.

Limitations

  • Wikilinks only connect documents within your own workspace. You cannot link to another user's documents.
  • The target document must exist for the wikilink to resolve. Creating a wikilink does not create a new document.
  • Wikilinks are not supported in the REST API response. The API returns raw markdown with [[brackets]] intact.