Storage

Your notes, settings, and extension data are stored as plain files on your machine. Nothing is locked in a proprietary database — you own the files and can move, back up, or edit them with any tool.

Where your notes live

By default, notes are in your app data folder:

To change the folder: go to Settings → Storage, click the path, and choose a new location. QuickPeach moves your existing notes there and updates immediately.

Note format

Each note is a Markdown file with a small metadata comment at the top:

<!-- quickpeach: {"id":"...","title":"...","pinned":false,"appearance":{...}} -->

# Note title

Your note content…

The metadata stores the note's id, title, pinned state, and appearance settings (theme color, text color, fade mode, inactive opacity). Everything else is standard Markdown.

To switch between Markdown and JSON format: go to Settings → Storage → Note format. Both formats are fully supported — switch at any time.

Notes are watched automatically

QuickPeach watches the notes folder for changes. If you edit a file in another editor (VS Code, Obsidian, vim) or a sync client moves a file, the app picks up the change without you needing to do anything.

Attachments

Images and files attached to notes live in a sub-folder alongside the notes. Attachments are referenced by path in the note Markdown.

Clean up orphaned attachments: Settings → Storage → Clean up attachments. This removes attachment files that are no longer referenced by any note.

Extension data

Each installed extension gets its own storage namespace under:

• ~/.quickpeach/extensions/<extension-id>/

Extension data is isolated — one extension cannot access another's data.

See extension storage usage: Settings → Storage gives a breakdown by extension. You can clear an extension's data from there without uninstalling it.

Settings file

settings.json lives in the app data root alongside the notes folder. It stores your preferences (hotkey, appearance, integrations, etc.). You can back it up like any other file.

Backups

The full backup and restore flow is in Settings → Security. A backup archive is an encrypted snapshot of notes, attachments, settings, and extension data. See Sync & backup for details.