Skip to content

Links & Tags

FoldNotes connects your notes through wiki-links, organises them with tags, and supports footnotes for references.

Link to another note by wrapping its title in double brackets:

See [[Meeting Notes]] for details.
Discussed in [[Project Plan]].

Wiki-links are clickable in the editor — Cmd+click (or just click, depending on your settings) opens the linked note. If the target note doesn't exist, FoldNotes offers to create it.

The Inspector's References tab and the fn backlinks command show which notes link to the current note. This creates a bidirectional knowledge graph without any manual effort.

fn backlinks "Project Plan"          # Notes that link to "Project Plan"
fn backlinks "Project Plan" --context  # Include surrounding paragraphs

Tags

Add tags anywhere in your note using # followed by the tag name (no space):

#project #meeting #urgent

Tags can be nested using / as a separator:

#project/alpha
#project/beta
#work/meeting

Tag Autocomplete

When you type #, FoldNotes shows a tag helper with autocomplete suggestions drawn from your existing tags. The helper understands hierarchical tags — typing #project/ shows all child tags under project. Press Return or Tab to accept a suggestion, or keep typing to filter the list.

Tag Rules

  • Tags must be preceded by whitespace or appear at the start of a line
  • Tags in headings are suppressed (the # is heading syntax, not a tag)
  • Tags inside code blocks are ignored
  • Tags are case-sensitive: #Project and #project are different tags

Browsing Tags

The sidebar can filter notes by tag. Tags with custom icons appear with their icon in the sidebar. The command line tool also supports tag queries:

fn tags                    # List all tags with note counts
fn tags "project/alpha"    # Show notes with this tag
fn list --tag project      # Filter notes by tag

Footnotes

FoldNotes supports footnote references and definitions:

This claim needs a source[^1]. Another point[^note].

[^1]: Smith, J. (2025). *Evidence-Based Claims*. p. 42.
[^note]: This is a longer footnote that can span
    multiple lines when indented.

How Footnotes Work

  • References ([^label]) appear inline in your text. They're styled as superscript links.
  • Definitions ([^label]:) appear at the end of your note (by convention) and contain the footnote content.
  • Multi-line definitions are supported — indent continuation lines with spaces or a tab.
  • Bidirectional navigation — click a reference to jump to its definition, click the definition's back-arrow to return to the reference.

Footnote labels can be numbers ([^1]) or text ([^note], [^source-2025]). They're matched by label, not by order.

Bare URLs in your text are automatically detected and become clickable:

Check out https://foldnotes.io for more info.

Standard Markdown links also work:

[FoldNotes](https://foldnotes.io)

Both styles open in your default browser when clicked.

Date References

Type @ on a non-task line to insert a date reference via a date picker. Date references appear as @YYYYMMDD in the Markdown and are styled with your accent colour in the editor.

On task lines, @ inserts a due:YYYY-MM-DD metadata entry instead.