← Docs
Local-first vault
Your markdown lives in plain files on your disk. MDDock adds a hidden index next to it — never replaces it, never owns it.
Layout
You can rsync the markdown out and read it anywhere. Delete .mddock/ and you're back to a plain folder of .md files.
Watcher
A filesystem watcher reconciles changes you make in any editor — VS Code, Obsidian, your terminal — back into the index within seconds. Conflict resolution lives in the
audit log
.
What stays local
- •All file content, history, and recall scores
- •API tokens, auth state, encryption keys
- •The hash chain for the event log
Nothing leaves the machine until you opt into sync or hit mddock publish.
Backups
The vault is one folder. Treat it like any other folder — Time Machine, Restic, plain tar. The audit log gives you point-in-time recovery without needing the backup tool to understand MDDock's internals.