# Zuwiki

## Linking between pages

> Category: Editor guide

---

## Pages

- [Welcome to Zuwiki](https://docs.zuwiki.com/welcome-to-zuwiki)

### Getting started

- [Create your first wiki](https://docs.zuwiki.com/getting-started/create-your-first-wiki)

### Core concepts

- [Wikis, categories, and pages](https://docs.zuwiki.com/core-concepts/wikis-categories-and-pages)
- [Page lifecycle](https://docs.zuwiki.com/core-concepts/page-lifecycle)
- [Page history and restore](https://docs.zuwiki.com/core-concepts/page-history-and-restore)

### Access & Sharing

- [Public vs internal wikis](https://docs.zuwiki.com/access-sharing/public-vs-internal-wikis)
- [Visibility for public wikis](https://docs.zuwiki.com/access-sharing/visibility-and-access)
- [Share links](https://docs.zuwiki.com/access-sharing/share-links)
- [Access grants](https://docs.zuwiki.com/access-sharing/access-grants)
- [Classification and sensitivity](https://docs.zuwiki.com/access-sharing/classification-and-sensitivity)

### Editor guide

- [Markdown basics](https://docs.zuwiki.com/editor-guide/markdown-basics)
- [Linking between pages](https://docs.zuwiki.com/editor-guide/linking-between-pages)
- [Icons and images](https://docs.zuwiki.com/editor-guide/icons-and-images)
- [Rich content blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Custom domain](https://docs.zuwiki.com/plans-account/custom-domain)
- [Zuwiki for open source](https://docs.zuwiki.com/plans-account/zuwiki-for-open-source)

### Integrations

- [MCP Server](https://docs.zuwiki.com/integrations/mcp-server)

---

# Linking between pages

A wiki without links is just a pile of pages. Links give it a shape.

## Linking to a page in the same wiki

Select some text in the editor, add a link and search for the page in the picker. Pick it and the editor inserts the right address. The picker also lists the headings of the page you are editing, so you can link straight to a section.

Underneath, an internal link is a path made of the category slug and the page slug, with an optional heading anchor:

```markdown
See [Page lifecycle](/core-concepts/page-lifecycle) for the status flow.
Jump to [Archived](/core-concepts/page-lifecycle#archived).
```

Use the picker rather than typing paths yourself, it gets them right.

## Addresses can change

Because the path contains the category and the slug, a link breaks when its target moves:

- Moving a page to another category changes its path.
- Changing a page's slug changes its path.

Zuwiki doesn't rewrite existing links, so they stop working. Settle a page's home and slug before linking to it from many places, and update the links when you do move one.

## Links to other sites

Standard Markdown, `[text](https://example.com)`. For links to internal tools, add a few words about what is on the other side, since a list of bare links is hard to scan.

## Where links help

Link the first time you mention something that has its own page, and at the end of a section as a pointer to the obvious next question. In a runbook, link every step that depends on another procedure.

Don't link the same target three times in one paragraph, and don't link the word "here". Link the name of the destination. Don't link to drafts from a published page, because readers land on a dead end.
