Creating a note
| Method | Action |
|---|---|
| Keyboard shortcut | Press N from the dashboard |
| Command Palette | Cmd+K → type "new note" |
| Dashboard button | Click + in the top bar |
| From the editor | Click + in the note list panel (left side) |
The editor layout
The note editor uses a two-panel layout:
- Left panel — a list of your notes, filterable by stash. Click any note to switch to it without leaving the editor.
- Right panel — the editor itself, with a toolbar, metadata bar, and writing area.
Click the chevron button (‹ / ›) in the top-left corner of the editor to collapse or expand the note list panel.
Filtering the note list by stash
At the top of the note list panel, use the stash dropdown to show only notes belonging to a specific stash. Select "All Notes" to show every note regardless of stash.
Writing area
StashSync.app uses a block-based rich text editor. Every paragraph, heading, image, or code block is its own block that you can reorder by dragging the handle on its left edge.
The editor placeholder reads: "Type / for commands, [[ for notes, $…$ for math…" — a hint for the three most common shortcuts.
Slash command menu
Type / anywhere in the editor to open the command menu. Available blocks:
| Group | Blocks |
|---|---|
| Text | Heading 1–6, Paragraph |
| Lists | Bullet list, Ordered list, Task list |
| Blocks | Code block, Blockquote, Horizontal rule, Toggle, Bookmark, YouTube, Iframe embed, Emoji, Embed Note, Image, Table, Attach File |
| Callout | Info, Warning, Tip, Danger |
| Math | Inline math, Block math |
| Insert | Date, Date & Time |
Formatting toolbar (bubble toolbar)
Select any text to reveal the bubble toolbar with:
| Option | Description |
|---|---|
| Headings (H1–H6) | Section headings |
| Bold / Italic / Underline / Strikethrough | Inline text emphasis |
| Inline code | Monospace code span |
| Superscript / Subscript | Raised or lowered text |
| Text color | Apply a color to selected text |
| Highlight | Background highlight (yellow, green, blue, pink, purple, orange, gray) |
| Text alignment | Left, center, right, or justify |
| Link | Insert or edit a hyperlink |
Drag to reorder
Every block has a drag handle (⣿) on its left side. Grab it to move blocks up or down within the note.
Code blocks
Insert a code block via / → Code Block. StashSync.app applies syntax highlighting automatically for common languages.
Task lists
Insert via / → Task List. Click a checkbox to mark a task complete. Completed items remain in the note so you can track history.
Callouts
Insert via / → Callout: Info / Warning / Tip / Danger to add a highlighted callout box for important information.
Toggle blocks
Insert via / → Toggle to create a collapsible section. Click the toggle arrow to expand or collapse it.
Math (LaTeX)
Type $...$ for inline math or use / → Block Math for a display equation. Both render using KaTeX.
Wiki links
Type [[ to open a note picker and link to another note. Wiki links display as clickable chips in the editor; clicking one navigates directly to the linked note.
Emoji
Type : followed by the emoji name (e.g. :smile:) or use / → Emoji to browse and insert.
Images
Use / → Image to insert an image from your StashSync storage. When offline, image insertion is disabled.
File attachments
Use / → Attach File to insert any file from your StashSync storage as a clickable link. Click the link in the editor to preview the file inline.
Embed Note
Use / → Embed Note to inline the content of another note directly within the current note.
YouTube & Iframes
Use / → YouTube to embed a YouTube video by URL, or Iframe Embed to embed any external URL as an iframe.
Metadata bar
Below the title row, a metadata bar shows context for the current note:
| Item | Description |
|---|---|
| Stash badge | The stash this note belongs to. Click to reassign. |
| Tags | Tags applied to this note. Click + to add a tag; click × on a tag chip to remove it. You can create new tags inline. |
| Edited timestamp | How long ago the note was last saved |
| Created timestamp | The full creation date and time |
| Backlinks | Number of other notes that link to this note via [[wiki links]]. Click to expand the list. |
| Word count | Total words in the note |
| Character count | Total characters |
| Reading time | Estimated reading time (words ÷ 200) |
| Highlights | Count of highlighted text spans |
Pinning notes
Click the pin icon in the toolbar to pin a note to the top of all note lists. Pinned notes appear in a separate "Pinned" section above the regular list. Click again to unpin.
Find & Replace
Press Cmd+F (or click the Find & Replace icon in the toolbar) to open the Find & Replace panel over the editor. Press Escape to close it.
Auto-save
Notes save automatically to your local device on every keystroke. You never need to press a save button. Changes sync to your other devices in the background when you're online.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
N | New note (from dashboard) |
Cmd+F | Open Find & Replace |
Escape | Go back to dashboard |
/ | Open slash command menu |
[[ | Insert wiki link to another note |
$...$ | Insert inline math |
Opening an existing note
Click any note card in the dashboard to open it in the editor. Inside the editor, click any note in the left panel to switch notes without returning to the dashboard.
Exporting a note
From the note editor, click the Export as Markdown button (downward arrow icon) in the top toolbar (same row as the note title). A .md file is downloaded to your device.
Deleting a note
- From the dashboard: click the ⋮ (more actions) button on a note card → select Delete → confirm with Delete.
- From the editor: click the Trash icon in the top toolbar → confirm with Yes in the inline prompt.
Deleted notes go to the Trash and can be recovered at any time before you empty the trash.
Trash & recovery
Recover accidentally deleted notes from the Trash.