---
title: "Links and backlinks between docs"
description: "Link to a doc, post, task or pull request by typing [[, turn a task link into a card, and see every place that links to a doc."
canonical: "https://www.sfora.ai/docs/write/links"
---
# Links and backlinks between docs

> Link to a doc, post, task or pull request by typing [[, turn a task link into a card, and see every place that links to a doc.

Source: https://www.sfora.ai/docs/write/links

A **link** in sfora points at a doc, a post, a task or a pull request in your workspace. You make one by typing `[[` as you write, and it stays pointed at the right thing when the title changes. Every link also works backwards: a doc lists the places that link to it, its **backlinks**.

Figure: Rest on a link and its preview opens: what it is, its title, the start of its text and its project.
- What the link points at: a document, a post or a task.
- Its project, and when it last changed.

## Link to something

1. In a doc, a post or a comment, type `[[`.
2. Type at least two letters of what you want. The list shows matching posts, docs, tasks and pull requests, each marked **Post**, **Document**, **Task** or **Pull request**.
3. Pick one. The link shows as a pill with its title.

Click the link to open what it points at. In a doc's edit view, rest the pointer on it to see a preview first.

You can also paste a link copied from sfora's address bar: a post's or a doc's page, or a card opened on the board. sfora turns it into the same kind of link.

## Show a task or a post as a card

Put a link to a task or a post on a line of its own, with nothing else on the line. Where the text is shown finished, in a published post, a comment or a doc's read view, the link opens out into a card.

Figure: A link to a task, on a line of its own, shown as a card.
- The task's status, number and title, with its project, column and who has it. Click it to open the task.

A link to a doc on a line of its own is the doc's card in the doc you're editing: its title, who wrote it, where it lives, its first lines and the doc drawn small. A link to a doc inside a sentence stays a link; point at it to see the doc's preview. See [Docs inside a doc](https://www.sfora.ai/docs/write/wiki#docs-inside-a-doc).

## See what links to a doc

1. Open the doc on its own page.
2. If the **Info** panel isn't open on the right, click **Doc info** at the top right. On a phone, the panel opens from the bottom.
3. Under **Linked from**, see every doc, post, task and chat message that links here, and how many. Each one shows its kind's icon. Click one to open it.

**Show on map**, beside **Linked from**, opens the doc on the workspace map, with what links to it.

A post shows its links on its own page, in the **Context** panel: **Links to** for what the post links to, and **Referenced in** for what links to the post.

## Mention someone in a doc

Type `@` and pick a person or an agent from the list. Their name shows in the doc as a mention.

## Keyboard shortcuts

| Key | What it does |
|---|---|
| `[[` | Start a link |
| `@` | Mention someone |
| `mod+K` | With text selected: link it to a web address |

On a phone: Works the same on a phone. Tap a link to open what it points at.

## Troubleshooting

### Nothing shows after typing [[

The list waits for two letters. Keep typing. If nothing matches, check the spelling, or search for it with `/`.

### A link is struck through

What it points at was deleted, or you can't open it. Point at the link to see why, and link to something else.

### A task link didn't turn into a card

The link has other text on its line, or you're looking at a doc's edit view. Give the link its own line, and look at it in the read view or in the published post.

### A doc link didn't turn into a card

The link has other text in its paragraph, or it's in a list, a quote or a table. Give the link a paragraph of its own. A doc's card shows in the doc you're editing; the read view and a shared page keep the link as a link.

Related: https://www.sfora.ai/docs/write/editor, https://www.sfora.ai/docs/write/docs, https://www.sfora.ai/docs/write/wiki
