00 First run
Slap Notes opens on a welcome note that doubles as these docs. There's no account step and no setup wizard — the vault already exists and the first note is already yours to edit. Break it, rewrite it, or delete it; Ctrl + Z undoes anything.
The top bar hides itself. Move the cursor to the very top edge of the window and it slides back in — the File, Edit, View, Window and Help menus, the page title, and the buttons for New, Templates, Today, outline, find, export, Cluster Brain, AI Research, focus mode and settings. Move away and it slides out, leaving the whole window to your writing.
The window's native menu bar is hidden too. Press Alt to bring it back.
01 Blocks & the slash menu
Every line is a block. On a new line, type / to open the block menu: text, headings, lists, to-dos, quote, callout, code, image, video, divider.
Or skip the menu and type the markdown instead — the block converts the moment you hit space. Every trigger is in the reference on the left, and they're the ones you already know: # for a heading, - for a bullet, [] for a to-do.
Hover any block and drag the grip handle on its left to reorder it.
02 Text styles
Select text and a floating toolbar appears with bold, italic, underline, strikethrough, highlight, inline code and links.
The raw markers work too, if you'd rather not lift your hands off the keyboard — **bold**, *italic* and the rest are listed under Text markers on the left.
03 Wiki links & the Cluster Brain
Type [[ to link a note. An autocomplete suggests notes you already have and offers to create the ones you don't — so you can link to a note before you've written it, then fill it in later.
Those links build the Cluster Brain. Open the graph from the network icon in the top bar to see every note and every connection at once. Each note also lists its backlinks at the bottom, so a note always knows who's citing it.
A fresh vault ships with a few notes already linked together — Research Hub, Ideas, Project: Launch and AI Research — so the graph has something to show you on day one.
05 Math & code
Inline math renders live between dollar signs: $E = mc^2$, or something longer like $\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$.
Code blocks get syntax highlighting by language:
// code blocks get syntax highlighting
function slap(idea) {
return idea.connect().toCluster();
}
06 Images & video
Paste or drag an image or video straight into a note, or use /image and /video from the slash menu. Media is stored locally alongside your notes and is included in your JSON backup and your vault export — nothing is uploaded anywhere.
07 AI Research
The sparkles icon in the top bar opens the research agent. It reads your Cluster Brain — your notes and how they link — then answers questions about what you've written, summarises the current page, finds connections you'd missed, or drafts new notes you can insert with one click.
Switch it on with your own key. Open Settings (the gear icon, or Ctrl + ,) and paste an Anthropic API key. It's stored only on this device and sent to the local server that talks to the API on your behalf.
Until you do that, the agent is off and the rest of the app carries on without it.
09 Own your data
Everything is local-first, and leaving is a first-class feature rather than an afterthought. The Download menu in the top bar gives you four ways out:
| Export | What you get |
|---|---|
| Export this note (.md) | A single Markdown file |
| Export vault (.zip) | One Markdown file per note with [[wiki links]] intact, an attachments/ folder holding every image and video the notes reference, and an all-notes.html copy. Unzip and open notes/ as an Obsidian vault, or open the HTML, select all and paste into OneNote |
| Backup everything (.json) | The whole vault including media, restorable in-app from Restore from backup… |
| Print / Save as PDF | Archiving and printouts — Ctrl + P |
Deleted a note by mistake? It goes to the Trash — the bin icon at the bottom-left of the sidebar — and you can restore it any time.
·· Where your files live
Notes are stored on your device and mirrored to plain JSON you can read, diff or back up with any tool you already use. Help → Open Notes Folder opens this directory in your file manager.
| Path | What |
|---|---|
| ~/.config/slap-notes/ | App data — your notes live here |
| ~/.config/slap-notes/workspace.json | Plain-JSON copy of the whole vault |
| ~/.config/slap-notes/workspace.prev.json | Rollback copy, written whenever the vault shrinks |
The app's own vault is authoritative: workspace.json is read back only when browser storage is empty, so a stale mirror can't undo a deletion or a restore on the next launch.