# 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)
- [Organize with Categories](https://docs.zuwiki.com/getting-started/organize-with-categories)
- [Publish Your First Page](https://docs.zuwiki.com/getting-started/publish-your-first-page)

### 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 Visual Touches](https://docs.zuwiki.com/editor-guide/icons-and-visual-touches)
- [Rich Content Blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI Pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Plans and Limits](https://docs.zuwiki.com/plans-account/plans-and-limits)
- [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 a pile of pages. Linking gives your knowledge base its shape.

## Internal links

To link to another page in the same wiki, select some text in the editor, add a link, and search for the page in the link picker. Pick it and the editor inserts the correct address for you. You can also link to a specific heading on the page you are currently editing, the picker lists those too.

Under the hood an internal link is stored as 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 straight to [the three statuses](/core-concepts/page-lifecycle#the-three-statuses).
```

Using the picker is the safest way to get this right, so you do not have to assemble the path by hand.

## A page's address can change

An internal link points at a path, and that path is built from the page's category and slug. So a link breaks if the target moves:

- Moving a page into a different category changes its path.
- Changing a page's slug changes its path.

In both cases existing links to the old location stop resolving, and Zuwiki does not rewrite them for you. Settle a page's home and slug before you link to it heavily, and when you do move one, update the links that pointed at it.

## External links

Standard Markdown:

```markdown
[Anthropic](https://www.anthropic.com)
```

For links that point to internal tools, add a short hint about what readers will find on the other side. A wall of bare links is hard to scan.

## When to link

- The first time you mention a concept that has its own page.
- At the end of a section, as a **see also** for the natural next question.
- In a runbook, on every step that depends on a separate procedure.

## When not to link

- Do not link the same target three times in one paragraph.
- Do not link words like **here**. Link the noun that names the destination.
- Do not link to drafts from a published page, the reader hits a dead end.