Connect documents with links
Open a folder and write links to the documents that belong together. Relative paths are resolved against the location of the document the link is written in.
[Specification](docs/spec.md)[[note]][[note.md#procedure]][[note]] is a document link with the extension left out. When several files share a name, give a path that distinguishes the one you mean.
See what links to a document, with backlinks
- Save the document you are interested in and open a folder that contains it.
- Press F6, or choose View → Backlinks, to open the panel.
- Once the index is built, the files that link to the current document are listed with their line numbers.
- Click an entry to jump to the line that links to it.
External URLs, embedded images and links that stay within the same document are not counted. If the document sits outside the workspace or has not been saved, follow the note in the panel and check the folder or save the file.
Hiding backlinks in the activity bar also stops the index from being built.
Find documents by tag
Write #spec or #api-v2 in the text. Text inside code blocks and inline code is not collected as a tag.
- Choose Hashtags in the activity bar.
- Type a tag name in the field. The leading
#can be left out. - Pick a document from the results. Matching uses tag names, not file names; it accepts partial tag names and ignores case.
Clicking a tag in the preview opens the same panel, filtered to that tag.
Keep the documents you use often
| Feature | What it is for | How |
|---|---|---|
| Favorites | A marker that stays with you across the folders you open | Ctrl+Shift+D, or add it from the right-click menu of an item |
| Pin | Fixes an item at the top of the tree for the current folder | Right-click the item and choose Pin |
| Recent files | Returns you to a document you had open recently | Choose it from the File menu |
The button that shows favourites only is at the top of the file explorer. It cannot be used together with the name filter.
If you would rather leave no history, turn off Settings → System → Remember recent files/folders. What has already been recorded is removed with Clear History.