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

Redirects

A page's address is its directory plus its slug, and the slug follows the title — so renaming a page, moving it to another directory, or both at once changes its address.

Every one of those changes leaves a redirect behind. The old address keeps working: #old-slug links resolve, and the old URL sends visitors to the page's current location. That holds through any number of moves and renames — each old address points at the page itself, not at another address, so nothing depends on a chain of redirects staying intact.

Moving a directory is covered too: every page beneath it keeps its old URL working, however deeply nested, and qualified #old-dir/slug links still resolve.

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