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

Was this article helpful?

Something missing? Suggest an improvement

Ready to try Keepsake?

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

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