Documentation
mdai is a local-first Markdown editor for macOS, Windows and Linux. Your
notes are plain .md files in a folder you choose (a vault), and every
feature below reads those files rather than a database of its own.
Getting started
Section titled “Getting started”- Install — download and first launch, per operating system
- Your first vault — open a folder and start writing
- The editor — the live document, tabs, the outline, slash commands, Focus mode
Your vault
Section titled “Your vault”- Vault and files — the file tree, watching the folder, Rescan Vault
- Finding things — command palette, quick switcher, full-text search
Connecting notes
Section titled “Connecting notes”- Wikilinks and backlinks —
[[link]]by name, what points back, and unlinked mentions - Tags — every
#tagin the vault, counted, with its lines
Getting things done
Section titled “Getting things done”- Tasks — checkboxes, tags and dates across every note
- Calendar — the dated ones, laid out on the month
The rest
Section titled “The rest”- AI setup (BYOK) — your own provider key, your own scope
- Export and sharing — PDF, HTML, clean Markdown
- Keyboard shortcuts — every key, and the ones that do not exist on purpose
- FAQ — pricing, trial, licenses, privacy
- Troubleshooting
Everything shipped is listed on the roadmap, and what changed in each version is on releases.