Skip to content
Baram

Wikilinks and tags

Section titled “Wikilinks”

Connect your notes using [[wikilinks]]:

  1. Type [[ — An autocomplete popup appears with matching files
  2. Select a file — The wikilink is inserted (e.g., [[My Note]])
  3. Cmd+click — Navigate to the linked page

Advanced wikilink syntax:

Syntax Description
[[page]] Basic link to a page
[[page|display text]] Link with custom display text
[[page#heading]] Link to a specific heading
[[page#^block-id]] Link to a specific block
[[paper.pdf]] Link to a non-markdown file Baram can view

Linking to other file types: A wikilink can name any file Baram opens in place — PDFs, HTML, images, SVG — by writing the extension: [[diagram.svg]], [[paper.pdf]]. The autocomplete offers these files alongside your notes and labels each one with its type, so you can tell a report.pdf from a report.md before you pick. Plain markdown links work too: [the paper](papers/attention.pdf) opens in Baram rather than handing the file to your operating system.

These links are indexed the same way links between notes are, so a PDF you cite appears in backlinks and as a node in the Graph View.

Hover Preview: Hover over any wikilink to see a preview of the target document’s content without navigating away.

Auto-Rename

Section titled “Auto-Rename”

When you rename a file in the file tree (select a file and press F2), all wikilinks pointing to that file are automatically updated across your workspace.

Tags

Section titled “Tags”

Organize notes with #tags, indexed across the entire vault:

  1. Type #tag inline (autocomplete suggests existing tags), or add a tags: list to YAML frontmatter
  2. Nested tags — Use #parent/child for hierarchy
  3. Cmd/Ctrl+click a tag to search every file that uses it

Tag panel: Open the Tags panel from the Activity Bar to browse tags as a tree or a frequency-sized cloud. From here you can:

  • Rename a tag across the whole vault
  • Assign colors to tags
  • Filter the file tree by tag
  • Get AI tag suggestions for the current note