Work with multiple note folders, import Obsidian vaults, and organize your workspace.

Default Vault

When you first open mdnb, your notes live in ~/mdnb. Every note is a plain .md file in a regular folder.

Adding Vaults

You can add multiple folders as separate vaults. Each vault appears as a top-level section in the sidebar.

There are three ways to add a vault:

• Settings > General > Notes: click "Add Folder..." to pick any directory
• Home screen: click "Import Notes" to add a folder or import an Obsidian vault
• Git Settings: cloning a repository automatically adds the clone destination as a new vault

Importing from Obsidian

mdnb auto-detects Obsidian vaults installed on your Mac. From the Home screen, click Import Notes > Import from Obsidian to see detected vaults. Since both apps use plain Markdown files, your notes work in both without conversion.

Switching Between Vaults

When you have multiple vaults, each appears in the sidebar with a drive icon. To switch the active vault:

• Right-click a vault folder in the sidebar and choose "Set Active Root"
• Click a vault row in Settings > Git to switch to it
• Select any file in a different vault to automatically switch

The active vault determines which folder new notes are created in and which repository is used for Git sync.

Removing a Vault

Remove a vault from Settings > General > Notes by clicking the remove button next to it, or right-click the vault in the sidebar and choose "Remove Root." You cannot remove the last vault. Removing a vault only removes it from mdnb's list; your files on disk are not deleted.

Search Across Vaults

The search palette (Cmd+P) searches across all vaults, not just the active one.