All chapters
Getting started
Daily work
Find and understand
Research and publish
Protect your notes
Reference
Capturing ideas
To get a thought out of your head, press ⌃⌥Space from any app, type it, and press ⌘↩. This chapter covers that box and every other way in: the Capture menu, the menu bar, your voice, images, web pages, and the places captures wait for you afterwards.
Quick Capture Anywhere
There are two ways to open it, and they behave slightly differently:
- From any app: press ⌃⌥Space. A small floating panel appears over whatever you're doing. Press the shortcut again (or click Close) to put it away. It stays open after you capture, so you can see where the thought went and add another.
- Inside Header: click Capture in the sidebar, or choose View → Quick Capture (⇧⌘0). It opens as a sheet over the main window and closes when you capture. Pressing Esc closes it and keeps what you typed for next time.
Type in the What's on your mind? box and press ⌘↩, or click Capture. That's the whole job. Everything else in the box is optional.
All the capture boxes share one draft. Start a thought in the menu-bar box, get interrupted, and it's still there when you open Quick Capture inside the app.
If you paste nothing but a web address, the box switches to Save a Link. Click Keep as text if you only wanted the address as a note.
Review or undo a capture
After a capture, the floating panel and the menu-bar box show a line like Captured to October 2026 Capture Log with two buttons:
- Review opens the note the capture landed in, in the main window.
- Undo puts that note back the way it was before the capture. If the capture made a new file, Undo moves the file to the Trash. If the file has changed since (you edited it, or it synced), Header leaves it alone and tells you why.
Undo also cancels the capture's reminder in Header. Anything already sent to Apple Reminders or Calendar stays there; Header doesn't delete things in other apps for you.
Where captures land
Under the text box, a quiet line says where the next capture will go, for example Saves to October 2026 Capture Log. Click it to choose one of three destinations. Your choice sticks, and it's the same setting as Settings → General → Capture → Quick captures go to.
| Destination | Where it writes |
|---|---|
| Monthly Capture Log (the default) | One Markdown file per month at the top of your vault, named like 2026-10 Header.md. Each capture is its own section headed with the date and time, newest first. |
| Daily Note | Today's daily note, wherever your daily notes live (see daily-note settings). If the note already has your own content, the capture is added at the end. |
| One File per Capture | A new file for every capture in Captures/2026-10/, named with the date, time and the first words of the thought. |
This only applies to quick captures. Notes you create with ⌘N are separate Markdown files, as always.
More: type, flags, context and recipes
Click More in the capture box to show the extra controls. You can ignore all of them; they reset to a plain note after every capture.
- Type. Note and Source save your text as written. Task turns it into a checkbox (
- [ ] …) so it shows up in Tasks and Today. Decision and Question start the text with Decision: or Question:. Meeting starts it with Meeting note: and today's date. - Flags (in the options menu beside Type): Follow-up, Blocker, Waiting and Important. Each adds a tag such as
#follow-up. - Context lists the
#tags,[[links]]and@namesHeader found in your text, so you can attach them to the capture. Flags and context are written on a Context: line under your text. - Once More is open, up to three recipes appear as buttons; the rest are in the options menu under More recipes. A recipe is a shortcut that sets the type and flags and adds tags in one click. The built-in ones are Quick, Idea, Decision, Task, Follow-up, Blocker, Meeting, Research, Client and Writer. Follow-up, for example, makes the capture a task with the Follow-up flag.
To make your own, open the options menu and choose Manage Recipes…, then New Recipe. A recipe has a name, a short description, an icon and the tags it applies. You can also turn built-ins off, or bring them back with Reset Built-ins. Recipes label and tag a thought; they don't add headings or empty sections. For a note with a fixed structure, use the editor's Templates instead.
clientx. Next time a client rings, choose it from the options menu (More recipes) before you capture, and every note from those calls carries the same tag.Suggestions and smart tags
While you type, Header looks for patterns in the text and offers them under Suggested:. It might suggest a type (“need to” suggests Task, “we decided” suggests Decision), a date, a person (from @Sam or “ask Sam”), a [[link]], a #tag, or a flag (“blocked” suggests Blocker). Click Accept all to apply every suggestion, or Edit to pick them one at a time. Nothing is applied until you do.
Separately, a Detected row shows smart tags Header will save with the capture: #idea, #task, #follow-up, #decision, #question or #stress, depending on the wording. They're written on a Tags: line in the capture.
Hashtags you type yourself stay in your text like any other tag, so you can find the capture later under Tags.
Dates and reminders
Write “Pay the deposit Friday” and Header spots the date. A pill under the box says Detected with the date, followed by “accept the date to set a reminder”. Until you accept it, nothing is scheduled. To accept, click Accept all in the Suggested row, or Edit and pick only the date. The pill then reads Reminder set for and the exact time.
Header understands today, tomorrow (or tmrw), weekday names (the next one to come, never today), and ordinary dates such as “October 30”. For the time:
- If you wrote one, it's kept: “call the dentist tomorrow at 3pm” fires at 3 PM.
- Otherwise the reminder fires at 9 AM that day.
- A “today” reminder accepted after 9 AM moves to the next full hour. A time that has already passed isn't scheduled at all.
When it's time, macOS shows a Header task due notification with Done and Snooze 15m. If you've turned them on in Settings → Calendar, the capture also goes to Apple Reminders (Send task reminders to Apple Reminders) and to your calendar as a 15-minute event (Also add due tasks to Calendar). Both are one-way copies.
Voice Note On-device
Press ⌃⌥V from any app, choose Capture → Voice Note, or click the microphone in the menu-bar box. Click Start recording, talk, and click Stop. The words appear in the text box as you speak, and you can correct them there.
The panel spells out what's happening: Transcription: On-device · Audio: Mic · Audio is not retained. Header uses Apple's on-device speech recognition, or the English-only Whisper model if you've set that up in Settings → Minutes. If on-device recognition isn't available for the language you picked, Header tells you and doesn't send the audio anywhere. Choose the language from the Language menu.
When the text looks right, click Finish (⌘↩). The transcript moves into Quick Capture, where the suggestions, reminders and Saves to line work as usual. Nothing is saved until you capture it there.
Photos, screenshots and videos
Drag an image or video onto the capture box (it says Drop visual context), or click the paperclip to choose files. Thumbnails appear under the text, and you can remove one before capturing. You don't need to write anything: an image on its own is a valid capture.
When you capture, Header copies the files into your vault under Header Attachments/2026-10/ and adds them under a Visual context: line, so the photo of the whiteboard sits right below what you wrote about it.
Save a Link
Copy a page's address in your browser, then choose File → Save a Link… (⇧⌘W). Quick Capture opens in link mode with the address already filled in. You can also start from Capture → Save a Link, the Save a Link button in the capture box, or by pasting a lone address into it.
Header reads the page and tells you how it went. Reading… becomes Article captured or Page captured when it found the text. Link only means Header will save the address without the page's text, and PDF linked means the address is a PDF. A preview shows what will be saved; tick Markdown to see the exact Markdown file Header will write.
- Images. A line reports how many images are saved locally and how many are still remote. Retry missing images tries the rest again. You can save before every image has arrived; the remaining ones stay as web links.
- Why save this? Add a reason, question or next step. It's saved with the clip.
- Where it goes. Clips go to
Web Clips/2026-10/; PDFs and pages from scholarly sites such as arxiv.org, doi.org or PubMed go toResearch Sources/2026-10/. Click the Saves to line to pick another folder, Reveal Destination in Finder, or Remember for This Domain so every clip from that site goes to the same place. - Details. Open it to correct the Title, Author, Publisher, Canonical URL, Description and Published date, set the folder (Create Folder makes it), add or remove tags, paste a highlight into Selected text / highlight, or edit the Captured content (Markdown) directly.
Then click Save (⌘↩), or Save link only for a bookmark without the page text. Discard throws the draft away. Saving a clip never calls AI; the line at the bottom of the panel says so. Fetching the page and its images does go to the website itself.
After saving you'll see Saved to and the file name, with Open, Undo and Done. When the clip has page text or a highlight, Ask about this also appears: it opens the clip and starts Ask Header on that one note.
If you've already saved the link
If the link is already in your vault, Header says You already saved this link and shows where. Choose Open existing, Append context to add your new highlight or reason to the old clip, or Save another copy.
PDFs and arXiv papers
For a PDF, Save Source PDF to Vault downloads it (or Attach PDF… picks one you have), so the clip still works if the link dies. Extract Full Text pulls the paper's text into the note, using on-device OCR for scanned pages. Papers full of equations get a warning, because maths doesn't survive extraction; read those in the Reading Room. For arXiv links Header fills in the real title, authors and abstract from arXiv, and Auto-fill from arXiv runs it again.
YouTube
A video is saved as a link with its title. To keep the transcript, copy it from YouTube's transcript panel and paste it in Details.
When a page won't load
You'll see Couldn't capture this page with the reason. Click Retry, or Save link only to keep the address.
Clips from other browser clippers
If you clip with a browser extension that saves Markdown into your vault, such as Obsidian Web Clipper or MarkDownload, point it at a folder called Clippings (or Inbox/Clippings) at the top of your vault. When a clip lands there, Header downloads its remote images into an assets folder beside it and adds Header's web-clip properties. The clip stays where it is, so you'll find it in Inbox.
Header only touches files that name a web address in their properties (a source, url, source_url or canonical_url field). If you edit a clip while Header is working on it, Header skips it and tries again later.
Captures in the sidebar
The Captures group in the sidebar collects the notes that usually need sorting:
- Inbox shows notes sitting at the top level of your vault, plus anything in a folder named Inbox, Captures, Capture Inbox or Clippings. Your monthly capture log lives at the top level, so it's here too.
- Web Clips appears once your vault has notes in a folder path containing “Web Clips” or “Clipped Pages”.
- Transcripts appears once your vault has notes in a path containing “voice”, “transcripts” or “dictation”.
These are views, not folders: nothing moves when a note appears in one. Move a note to another folder and it leaves the Inbox.
Review Captures
Click Review Captures under Captures in the sidebar, or choose View → Show Review Inspector (⌥⌘I). A panel opens on the right listing your quick captures for Today, Week or Month. The calendar button jumps to a different day, week or month.
Hover over a capture to act on it:
- Edit opens it in the editor, in the file where it lives.
- Save as Note turns it into a note of its own at the top of your vault, with a line saying which log it came from and when. The original stays in the log.
- Delete removes it from its Markdown file after you confirm. Header can't undo this one.
The Month view also holds the Monthly Retro. See Mindprint, Review & Retro.