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.
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.
- What the link points at: a document, a post or a task.
- Its project, and when it last changed.
Link to something
In a doc, a post or a comment, type [[.
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.
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.
- 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.
See what links to a doc
Open the doc on its own page.
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.
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 |
| ⌘CtrlK | With text selected: link it to a web address |
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.
Last updated on
Writing in the editor
Write in Markdown, add blocks from the slash menu, move and copy blocks, draw diagrams, and find and replace text.
The Library (retired)
The Library page is retired. Docs live in Docs, uploads on a project's Files tab, and deleted docs in the Trash at the foot of the Docs sidebar.