All chapters
  1. Getting started

    1. Start here
    2. Install, update & first launch
    3. Bring your notes in
    4. Your vault & the window
  2. Daily work

    1. Writing & the editor
    2. The Note Inspector & history
    3. Capturing ideas
    4. Today & daily notes
    5. Tasks
    6. Minutes: recording meetings
  3. Find and understand

    1. Finding & connecting notes
    2. Setting up AI
    3. Ask Header
    4. AI writing tools: Review, Refactor & the selection assistant
    5. Lenses
    6. Atlas
    7. Mindprint, Review & Retro
  4. Research and publish

    1. Research & the Reading Room
    2. Manuscripts
    3. Boards
  5. Protect your notes

    1. Trust, safety & privacy
    2. Sync & backup
  6. Reference

    1. Header across macOS
    2. Settings
    3. Keyboard shortcuts
    4. Help, feedback & FAQ
The basics

Finding & connecting notes

There are three ways to get back to a note: search for words in it, jump to it by name, or follow the links between notes. This chapter covers all three, plus tags, stars and the Graph.

Know a word in it?

Type in the search field above the note list.

Know its name?

⌘K inside Header, or ⌃⌥F from any app.

Know what it's about?

Follow tags, backlinks and the Graph, or ask Ask Header.

Jump to Note

Search every vault from any app

Press ⌃⌥F from anywhere on your Mac, even while you're in another app. A small Jump to Note panel opens with a field that searches every Markdown file in every vault. Type two or more letters and click a result to open it in Header. Each result shows the vault, the date and a short excerpt. Hover a result for a preview with Open in Editor, Open Externally (your default Markdown app) and Reveal. Press Esc or click Close to dismiss it.

The same panel is in Window → Jump to Note, in Header's menu-bar window, and in ⌘K as Search All Notes. To use different keys, go to Settings → Shortcuts → Global Shortcuts; a shortcut needs at least two modifier keys. ⌃⌥H (Show Header) brings the main window forward.

Find it ⌃⌥F · Window → Jump to Note

Command palette

Notes and commands in one list

Press ⌘K while Header is in front. The box says "Run a command or jump to a note…". As you type, one list fills with matching notes, boards and commands, each marked Note or Command. You don't need whole words: the letters only have to appear in order, so jptr finds Japan Trip. Use ↑ ↓ to move, Return to open, and Esc to close.

Commands worth knowing: New Note, Open Graph, Open Tags, History (the open note's timeline), and Search All Notes, which opens Jump to Note.

Find it ⌘K · File → Command Palette · ⋯ → All Commands…

Tags and the Tags browser

Every #tag in the vault, with counts

Write a tag anywhere in a note as #tag: at the start of a line or after a space, starting with a letter A–Z, then using letters A–Z, numbers, _, - or /. #reading-list and #client/acme both work. Capitals don't matter, so #Travel and #travel are the same tag. Tags in the note's tags: property count too. Typing # in the editor suggests tags you already use.

The Tags browser lists every tag with the number of notes that use it. Filter the list, sort it by Most Used or A–Z, and click a tag to see its notes and a Related row of tags that often appear with it. Click a note to open it. To go back, press Esc or click the close button (Return to Notes).

In a note, hover a tag to see how many notes use it and the first few of them, with See all in Tags →. ⌘-click a tag to open it in the Tags browser. Header has no command to rename or merge tags; change them in the notes themselves.

Find it Sidebar → Library → Tags · View → Tags ⌃⌘4 · ⌘K → Open Tags

Starred notes and pinned folders

Keep the few you use most within reach

Star the notes you come back to every week, say a project hub or this term's reading list. Right-click a note and choose Star Note, or press ⇧⌘B (View → Toggle Starred) for the open note. They collect under Library → Starred, which shows a count. Stars are kept in a small file in the vault's hidden .header folder, not inside your notes, so starring doesn't change a note's text.

For folders, right-click one and choose Pin to Sidebar. It appears under Pinned with its note count. See Your vault & the window.

Find it right-click a note → Star Note · ⇧⌘B · right-click a folder → Pin to Sidebar

The Graph

A map of notes and the links between them

Choose View → Vault Graph (⌃⌘3). Every note and board is a dot, and every [[link]] is a line. Colours mark groups of closely connected notes. A note with no links is still there, on its own, which makes the Graph a good place to spot notes you never connected.

Japan Trip Hotels Budget Kyoto Food list Flights Temples Packing list Old ideas
Solid lines are links you wrote. The dashed line is an inferred connection, drawn when Show inferred links is on. Old ideas has no links, so it sits on its own.
  • Find a note: type in Search notes to dim everything else, and press Return to focus the first match.
  • Look closer: click a dot to select it and highlight its neighbours. Right-click it for Open Note or Open Local Graph, which shows only that note and the notes one link away.
  • Narrow it down: the filters All, Decisions, Open Loops, High Impact, Questions and Dormant (untouched for about four months), or switch from Map to Timeline.
  • Move around: the zoom buttons, a trackpad pinch, or the mini-map in the corner.

For one note's surroundings, open it and choose ⋯ → Graph of This Note. Save the note first; the command is greyed out while it has unsaved changes. In a vault with more than 140 notes on screen, the full graph starts with a selection and says "Showing … high-signal notes".

With a note selected, the Graph Inspector can list Suggested Links: notes that look related but aren't linked. Clicking Link writes the link straight away, with no preview. It adds a line like Related: [[Packing list]] — latent connection: … to the end of the selected note. If you'd rather word it yourself, dismiss the suggestion and add the link by hand.

Find it View → Vault Graph ⌃⌘3 · Sidebar → Explore → Graph · ⋯ → Graph of This Note
Spotlight: Header can also add your notes to macOS Spotlight, so they turn up when you press ⌘Space. Turn it on in Settings → General → Capture → Include notes in macOS Spotlight search. It's on by default only on macOS 27 and later. See Header across macOS.