Wiki links, tags and the graph
Link pages to each other, see what links back, find pages that name a page without linking it, tag pages, and explore the wiki as a graph.
Pages in the wiki connect. Link one page from another and the second knows about it: its backlinks list the first. Tag pages with #billing and every billing page is one click away. The graph draws the whole wiki and how it hangs together, so you can see which pages are central, which stand alone, and what a page sits next to.
Writing pages is covered in the wiki guide.
Link a page
Section titled “Link a page”- Type [[ and part of a page’s title, then pick it. When no page has that title, New page “…” makes one under the page you are on and links it, so you can link first and write later.
- Type @ and pick a page under Pages.
- Select text, click Link in the toolbar and type to search pages.
- Link to page in the / menu starts a [[ link.
- Copy link to block in a block’s menu gives an address that opens the page at that block. Paste it into any page or message.
A link shows the page’s current title and icon, so renaming a page never breaks it. A link to a page that was deleted reads This page was deleted.
Page previews
Section titled “Page previews”Rest the pointer on a link to a page and a preview opens: its icon, title, where it sits and how it starts. Read a page without leaving the one you are on.
The page panel
Section titled “The page panel”Click Page panel in a page’s header, or press mod shift ;. The panel opens beside the page, with a tab for each of these:
- Outline: the page’s headings. Click one to scroll to it.
- Links: what links here and where this page links to. See below.
- Graph: the page’s local graph.
- Comments: the page’s comments.
- Info: words, characters and reading time, the page’s tags, who created and last edited it and when, how many subpages and versions it has, and its Readers: how many views from how many people, and who read it lately.
Under a page’s title, “3 backlinks” opens the Links tab.
Backlinks
Section titled “Backlinks”The Links tab has:
- Linked mentions: the pages that link to this one, with the passage around each link.
- Unlinked mentions: the pages whose text names this page’s title without linking it. Click Link to turn the first such mention in that page into a link, without opening it.
- Links on this page: the pages this one links to.
- Tickets mentioned: the tickets this page mentions. See Tickets, the help center and Ollie.
Backlinks stay current as people write: a link counts as soon as its page is saved, and goes when the link or the page does.
Type # and a word anywhere in a page, like #billing or #runbook, and the page is tagged. The tag shows tinted in the text; click it while reading, or mod click it while writing, to see every page with that tag.
- A tag has letters, digits,
_,-or/, and at least one letter:#42is a number, not a tag. - A tag at the start of a line or after a space counts. One inside code doesn’t.
- Tags ignore case:
#Billingand#billingare the same tag. /nests tags:#process/refundsis under#process.
Open Tags at the bottom of the wiki’s sidebar for every tag in the wiki with how many pages carry it, nested tags under their parents. Filter tags narrows the list; pick a tag to see its pages. A page’s tags are also in the Info tab of its panel.
The graph
Section titled “The graph”Open Graph at the bottom of the wiki’s sidebar, or from the wiki’s home. Each page is a dot and each link a line between two dots. Pages that share a top-level page share a colour.
- Scroll to zoom, drag to move, double-click to fit. With the keyboard, the arrow keys move it, + and - zoom and 0 fits it.
- Rest the pointer on a page to see its name and its neighbours. Click it to open the page.
- Filter pages shows only the pages whose title has the words you type.
- Subpages as links draws a line from each page to its subpages too, so the wiki’s outline shows as well as its links.
- Pages without links shows or hides pages nothing links to and that link nowhere.
- Tags: pick a tag to show only its pages.
A page’s local graph
Section titled “A page’s local graph”The Graph tab of a page’s panel draws only that page and its neighbours: 1 step for the pages it links to and from, 2 steps to go one further. Full graph opens the whole graph centred on the page; Show every page there leaves the page and draws everything again.
A random page
Section titled “A random page”On the wiki’s home, Open a random page opens any page of the wiki. A good way to find what needs updating, or to rediscover something useful.
What counts as a link
Section titled “What counts as a link”
What counts as a link
Section titled “What counts as a link”- A link made with [[, @, the toolbar or a pasted address of a wiki page, and a subpage shown in a page’s text.
- Only pages of the same workspace, and only pages you can see: a link to a private page or to a private team’s page shows in nobody else’s backlinks or graph.
- Pages in the trash and templates are left out of backlinks, the graph and tags.
- An unlinked mention is a page’s whole title, as a phrase, in another page’s text. Pages without a title have none.