Skip to content

Your first vault

A vault is just a folder on your disk. mdai scans it for .md files, shows them in the file tree, and indexes every task it finds. Nothing is imported, converted, or locked in — the folder stays a normal folder.

A vault is optional: Open File… (⌘O / Ctrl+O) works on any Markdown file, and mdai saves it back where it was. A vault adds the file tree, tasks, tags and backlinks across all your notes.

  1. In the left rail, click More → Open Vault, or use File → Open Vault… (⇧⌘O / Ctrl+Shift+O). On first launch the welcome screen offers Local folder… instead.
  2. Pick any folder — an existing notes folder works fine, mdai never rewrites files you don’t edit. If you pick the whole Documents folder, mdai offers to create an “mdai” folder inside it, so your notes don’t mix with your other documents; Use all of Documents keeps Documents as it is.
  3. The file tree appears in the sidebar. Click any file to open it.
  • Type Markdown and watch it render inline as you write — # headings, **bold**, lists, quotes, code.
  • Auto-save writes your changes to disk after a short pause. A new tab is Untitled until you save it once; the first save starts in your vault’s folder. If mdai closes unexpectedly, it offers to restore it.
  • Multiple files open as tabs; switching tabs never loses changes.

The narrow bar on the left keeps only what you reach for most: Files, Vault Search, Outline, Ask AI, Writing Mode and Settings. More opens the rest — Todo, Calendar, Backlinks, Tags, Properties, Graph view, Git and Open Vault. Every one of them is also in the menus and in the command palette (⇧⌘P / Ctrl+Shift+P).

Point at an icon to see its name and its shortcut. The rail is pinned, so it is always there; Unpin rail, the pin just above Settings, lets it step aside — then three dots on the left edge mark where it is, and moving the pointer there brings it in. Pin rail puts it back, and mdai remembers your choice.

An open panel has a dot next to it, on the rail and in More. At most two panels are open on the right at once: opening a third closes the one that has been open longest, so the editor keeps its room.

Close the last tab and mdai shows a start page instead of an empty window: the notes you opened most recently, and the main actions with their shortcuts — with a vault open, Open Today’s Note, Quick Switcher and the command palette; without one, Open Vault… and Open File….

Your vault may live in an iCloud/Drive/Dropbox folder or be edited by other tools. mdai watches the disk and follows one rule: it never silently overwrites external changes. If a file changed on disk while your editor copy is clean, it reloads. If both changed, mdai asks you which version to keep.

Exactly where you put it. mdai adds no database and no hidden format — uninstall it tomorrow and your notes remain plain Markdown files.