Docs.
The complete reference, split between the app and the command line tool. Every shortcut, every setting, every command.
Using the app
Installing Jotura, opening a vault, and getting your notes onto every device.
- Getting started How to install Jotura, open a folder as a vault, see what it writes to disk, and find your way around the sidebar, tabs, and command palette.
- The editor Reference for the Jotura editor: markdown input rules, the slash menu, source mode, tables, lists and checkboxes, links, images, and autosave.
- Keyboard shortcuts Every keyboard shortcut in the Jotura desktop app, covering global chords, editor and formatting keys, tables, the file tree, and the Escape cascade.
- Search Quick open, the sidebar keyword pane, the three-mode search page, semantic search setup, and finding text inside imported PDFs and Word files.
- Sync and sharing How to turn on end-to-end encrypted sync, what the server can and cannot see, and how to share a folder or a single file with someone else.
- Version history What Jotura keeps in a note's timeline, how to open it, how to compare and restore earlier versions, and how edits are attributed in shared vaults.
- Documents How Jotura stores PDFs, Word files and spreadsheets, mirrors them into searchable markdown, and keeps that mirror current as the originals change.
- Daily notes, tasks, and templates How Jotura creates and navigates daily notes, gathers markdown checklist items into a vault-wide task list, and applies templates to new notes.
- Settings reference Every Jotura desktop setting with a UI control, grouped as the settings screen groups them, with its effect, its default, and where it is stored on disk.
- Troubleshooting What to do when sync pauses, a note looks unsaved, search finds nothing, an installer is blocked, or you need to restore something you deleted.
The CLI
The jotura command line tool, for driving a vault from a terminal or an AI agent.
- Install and setup How the jotura command line tool reaches your PATH on each platform, how it picks a vault, and what its global flags and exit codes do.
- Reading and searching Reference for the Jotura CLI commands that only read: read, ls, quick-open, search, grep, backlinks, links, and the two document commands.
- Editing notes How to change note content from the Jotura CLI: the read-then-write hash loop, every edit operation, multi-op applies, batches, and conflict recovery.
- Frontmatter and tags How the Jotura CLI reads and writes YAML frontmatter and tags, what its narrow YAML editor cannot change, and the exit codes each command returns.
- Creating, moving, and deleting Create, rename, delete, trash, restore, and template notes from the jotura CLI, including daily notes and the four template variables.
- Documents from the CLI Import PDFs and Office files into a Jotura vault from the command line, then list, search, and regenerate the markdown mirrors the CLI builds.
- Sync and shares How the jotura CLI reports sync state, caches the sync key, lists shares, and refuses writes into view-only share mounts, plus the exit codes involved.
- The agent surface Reference for the jotura CLI agent commands: memory, context, conventions, agents sync, skill install and hook install, with every flag and exit code.
- Watching and diagnostics Reference for jotura watch, status, vault info, doctor, and conventions: the event stream, the polling model, every health check, and the exit codes.
- Exit codes and JSON output The complete jotura exit code table, the JSON error object on stderr, the output shape of every command, and how to tell a usage error from a hash conflict.