Linking Pages

Linking Between Wiki Pages

The wiki supports a special syntax for linking to other pages using their path (or just their slug, when unambiguous).

Wiki link syntax

Type # followed by a page's path (directory + slug):

See #help/markdown-syntax for formatting help.

The directory portion is optional when the slug is unique across the wiki — plain #markdown-syntax also works when only one page has that slug. Whatever form you use, the link renders as a clickable link with the page's title.

Link to a specific section

Append #section-id to link into a heading on the target page:

See #help/markdown-syntax#code-blocks for the fenced-code rules.

How it works

1. When you save a page, the wiki finds all #... references
2. Known paths are converted to titled links: [Markdown Syntax](/c/help/markdown-syntax)
3. Unknown paths appear as red links, indicating the page doesn't exist yet

Finding a page's path

The path is the directory plus slug, matching the URL. For example:

• Title: "Getting Started Guide"
• Path: help/getting-started-guide
• URL: /c/help/getting-started-guide

Slug redirects

When a page's title changes, the slug changes too. The old (directory, slug) combination is preserved as a redirect, so existing #old-slug links continue to work.

Autocomplete

In the editor, typing # followed by two or more characters triggers an autocomplete dropdown. Select a page from the list to insert its full path — so new links are always unambiguous even if someone later creates a second page with the same slug elsewhere.

Backlinks ("What links here")

Every page tracks which other pages link to it. Click Actions → What links here to see all incoming wiki links, regardless of whether the source used the bare #slug or the qualified #dir/slug form. This is useful for understanding how a page fits into the broader wiki — and the wiki uses this information to prevent you from deleting a page that other pages link to.

Tips

• Slugs are lowercase with hyphens: my-page-title
• Two pages in different directories can share a slug — use the qualified #dir/slug form when that happens
• Red links are a good way to plan pages that don't exist yet