# Links

You can link to pages and records with double brackets. Known tracks these links, so you can see what links to a page before you move or change it.

## Link to a page

To link to a page in the same wiki, put its path in double brackets. To set the link text, add `|` and the text:

```
See [[handbook.onboarding]] for the first week.
See [[handbook.onboarding|the onboarding guide]] for the first week.
```

Without link text, the link shows the page's path.

Inside a Markdown table, escape the bar as `\|`.

## Link to a record

To link to a row in a [table](https://known.info/docs/records), add `/` and the row's key to the page path:

```
Renewal owner: [[customers/acme|Acme]].
```

Links also work inside records. A string field that contains `[[customers/acme]]` is tracked the same way as a link on a page.

## Link to another wiki

To link to a page in another wiki in your organization, add the wiki's name and a colon:

```
The budget is in [[finance:budget.2026]].
```

Links between wikis work in the browser, but `wiki links` doesn't list them yet.

## See what links to a page

```
known acme wiki links general:handbook.onboarding
known acme wiki links crm:customers/acme
```

The command lists every page and record that links to the page or record. In the browser, a record's page lists them under **Linked from**.

## Broken links

A link to a page that doesn't exist is shown muted, with a dashed underline. Clicking it shows a "not found" page that links to the nearest existing page above that path.

Moving a page doesn't update links to it. Run `wiki links` before you move a page, then update the pages that link to it.