Docs · v0.1.1

How to use Slap Notes.

Every feature, in the order you'll meet it. This is the same walkthrough that ships as the welcome note inside the app — so you can read it here, or open Slap Notes and edit it as you go. The quick reference stays pinned on the left as you scroll.

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.

04 Tags

Drop a #tag anywhere in a note and it renders as a pill. Click one — in the note or in the sidebar — to search every note that uses it. Tags cut across the graph when you'd rather query than wander.

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 block
// 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:

ExportWhat 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 PDFArchiving 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.

PathWhat
~/.config/slap-notes/App data — your notes live here
~/.config/slap-notes/workspace.jsonPlain-JSON copy of the whole vault
~/.config/slap-notes/workspace.prev.jsonRollback 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.

Slap Notes — coming soon Back to the overview

Docs for 0.1.1 · mirrors the welcome note in the app