Slash Commands — Format Notes Without Leaving the Keyboard

Slash commands are a keyboard-first way to format and transform notes. Type / anywhere in a Keepsake editor — the QuickNote bar, an inline editor, or the full note page — and a small palette opens with every available action. Pick one with the arrow keys or by typing a few letters, press Enter, and you're done. The same mental model as #tags and @mentions, applied to formatting.

Open the command palette

One key is all you need. The palette is context-aware: it appears where your cursor is and closes the moment you pick a command or press Escape.
1

Type /

In any Keepsake editor — QuickNote bar, inline entry editor, or the note detail page — type / at the start of a line or in the middle of your text. A small dropdown appears right at the cursor.

2

Filter by typing

Keep typing a few letters to narrow the list. /h1 jumps straight to heading 1. /ta narrows to task. /im to image.

3

Pick and go

Use the arrow keys to move through the list, then Enter to confirm. Or press Escape to close the palette without inserting anything.

Shortcut

Type / to open, Esc to close, arrows + Enter to pick

Tip

The slash palette uses the same UX as the # tag and @ contact autocomplete you already know. If you're comfortable with those, slash commands will feel instantly familiar — see QuickNotes.

Format text: headings, lists, tasks, quotes, code

Most slash commands are text formatters. They insert the right Markdown syntax at the cursor so you don't have to remember it.
1

/h1 and /h2

Insert a level-1 or level-2 heading. Great for structuring a longer note or a draft post you plan to publish.

2

/list

Insert a bullet list. Press Enter on an empty bullet to end the list.

3

/task

Insert a checklist / task list (- [ ]). Check items directly in the rendered view — perfect for quick daily checklists or shopping lists inside a note.

4

/quote

Insert a blockquote. Great for capturing a line from a book, a quote from a conversation, or an idea you want to highlight.

5

/code

Insert a code block. Monospace font, preserved formatting — ideal for commands, snippets, or anything technical.

6

/separator

Insert a horizontal rule — a subtle divider between sections of the same note.

Tip

All of these can also be typed directly as Markdown (# heading, - item, > quote). Slash commands are just a discoverable shortcut — see the full syntax in the Markdown guide.

Insert an image with /image

Typing /image opens your file picker so you can insert an image at the cursor. It's one of several ways to add a photo — see Adding photos to notes for the full picture (camera, drag & drop, paste).
1

Type /image at the cursor

The command palette narrows to image. Press Enter.

2

Pick a file

Your OS file picker opens. Choose one or several images. They upload, get compressed automatically (max 1200px, JPEG 80%), and are inserted inline at the cursor.

Tip

Use /image when your hands are already on the keyboard. Use drag & drop when the image is already in a Finder window. Use paste when it's on your clipboard. All three produce the same result.

Transform the note with /split and /duplicate

Two slash commands do more than insert content — they reshape the note itself. Use them when a note has grown bigger than its original intent.
1

/split — cut a note in two

Place your cursor where you want the split. Type /split and confirm. Everything below the cursor becomes a new note; everything above stays in the original. Tags, contacts, and any other metadata from the source note are preserved on the original — the new note starts clean, with just its content.

2

When to use /split

A note started as a quick idea and grew into three unrelated thoughts? Split each one into its own note. Your inbox and your archives stay focused, one note = one idea.

3

/duplicate — clone the current note

Type /duplicate to create an exact copy of the current note. Useful for iterating on a draft, creating a template, or running variations of a checklist.

4

When to use /duplicate

Daily standup template? Weekly review checklist? Duplicate the previous one and edit — faster than recreating the structure every time.

Tip

/split and /duplicate are destructive-feeling but non-destructive: the original note is preserved either way. Try them without fear — you can always delete the new note if you change your mind.

Tips: combining slash commands with tags and contacts

Slash commands play well with the rest of Keepsake's text conventions. Use them together to move fast.
1

Structure first, then annotate

Use /h1 and /h2 to lay out sections, then add #tags and @contacts inside each section. The whole note stays discoverable from multiple angles.

2

Tasks inside notes

Use /task inside a longer note to keep a short action list close to its context. When the actions are more than a side list, consider turning them into real tasks with the T+ shortcut instead.

3

Draft → publish flow

Draft long-form content in a note using /h1, /quote, /image and /separator. When it's ready, publish the note to your Keepsake Page with one click.

4

Typed Markdown still works

If you prefer typing Markdown directly (## for an h2, - [ ] for a task), nothing changes. Slash commands are an alternative, not a replacement.

Tip

Slash commands are optimized for the flow state: don't stop to think about formatting, let the palette suggest it. The goal is always the same — capture first, polish later.

Related guides

Something missing? Suggest features

Ready to try Keepsake?

Start organizing your relationships, notes, and tasks today. Free for 7 days.

One click — you're in. No credit card. 7 days free.