Documentation

How to write, organise, sync and share your notes in Jotura on desktop and Android, down to each keyboard shortcut and setting.

Start here

01Getting startedHow 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.
02The editorHow to write in Jotura: formatting, the slash menu, lists and checkboxes, links between notes, images, tables, callouts, saving, exporting, and the Markdown view, with technical details at the end.
03Keyboard shortcutsEvery keyboard shortcut in the Jotura desktop app, covering global chords, editor and formatting keys, tables, the file tree, and the Escape cascade.

Using the app

Installing Jotura, writing and organising notes, syncing and sharing them, and reading books on your phone.

Getting startedHow 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.
Coming from ObsidianOpen an Obsidian vault in Jotura as it stands: what Jotura reads from .obsidian, which syntax carries over, what it ignores, and which Obsidian features it lacks.
The editorHow to write in Jotura: formatting, the slash menu, lists and checkboxes, links between notes, images, tables, callouts, saving, exporting, and the Markdown view, with technical details at the end.
Daily notes, tasks, and templatesHow Jotura creates and navigates daily notes, gathers markdown checklist items into a vault-wide task list, and applies templates to new notes.
Keyboard shortcutsEvery keyboard shortcut in the Jotura desktop app, covering global chords, editor and formatting keys, tables, the file tree, and the Escape cascade.
SearchQuick open, the sidebar keyword pane, the three-mode search page, semantic search setup, and finding text inside imported PDFs and Word files.
Sync and sharingHow 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 historyWhat 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.
DocumentsHow Jotura stores PDFs, Word files and spreadsheets, mirrors them into searchable markdown, and keeps that mirror current as the originals change.
Books and highlightsReading EPUB, PDF and CBZ books on Android, how your place syncs, and how highlights become a Markdown note per book that you can edit on any device.
Settings referenceEvery 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.
Custom themesRecolor the Jotura desktop app with one JSON file in your vault: turning it on, every token it accepts, contrast targets, ten starter palettes, and what happens when the file breaks.
TroubleshootingWhat 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 setupHow 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 searchingReference for the Jotura CLI commands that only read: read, ls, quick-open, search, grep, backlinks, links, and the two document commands.
Editing notesHow 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 tagsHow 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 deletingCreate, rename, delete, trash, restore, and template notes from the jotura CLI, including daily notes and the four template variables.
Documents from the CLIImport 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 sharesHow 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 surfaceReference for the jotura CLI agent commands: context, conventions and memory, with every flag and exit code, plus where the Jotura skills come from.
Watching and diagnosticsReference 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 outputThe 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.