better-vault
DocsPricingRoadmapDownloadGitHub repository14Get started
DocsPricingRoadmapDownloadGitHub repository14Get started

Get started

What is better-vault?Get startedDesktop appProviders and modelsStorageSubscription and accountPrivacy and your dataSelf-hosting

Using better-vault

NotebooksSourcesChat and citationsNotes, links and graphSkills and MCP for AI agents

Studio

The StudioAudio OverviewReportFlashcardsQuizData tableMind mapSlide deckInfographicAnatomyWhiteboard

Project

better-vault vs NotebookLMFAQRoadmapArchitectureAdd a Studio toolAdd a providerTranslationsllms.txt

Notes, links and graph

Write linked Markdown notes in better-vault: connect notes, notebooks and sources with [[double brackets]], see backlinks, browse the graph and use a canvas.

Notes are Markdown documents you write yourself, next to your notebooks, and link together with [[double brackets]].

Write a note

Open Notes in the sidebar of the notebooks page and press the + button, or press ⌘N (Ctrl+N on Windows and Linux). Click the title to rename the note, and write below it. Notes belong to a vault, so each vault has its own.

The editor shows formatting as you type. Markdown marks such as ** or # hide on every line your cursor isn't on, so the note reads as formatted text, and they come back where you edit. Press ⌘E to switch between editing and reading.

Link notes, notebooks and sources

Type [[ to link another note. A menu suggests notes from every vault, and the link opens that note when you click it. A link to a note that doesn't exist yet is drawn faded, and clicking it creates the note.

You writeIt links to
[[Research plan]]the note named Research plan
[[Research plan#Goals]]the Goals heading of that note
[[Research plan|the plan]]the same note, shown as "the plan"
![[Research plan]]the note, embedded in place
[[nb:Biology]]the notebook named Biology
[[src:Paper.pdf]]a source in any notebook
[[Work/Plan]]the note Plan in the vault named Work

Renaming a note updates every link to it, in every vault. Notes also understand #tags, - [ ] tasks, ==highlights==, > [!note] callouts and YAML frontmatter with tags and aliases.

Backlinks and the graph

The panel beside a note lists the notes that link to it, and the notes that mention its title without linking it; press Link to turn a mention into a link. Its Outline tab lists the note's headings.

Press ⌘G to open the graph. Every note is a dot and every link a line, with each vault in its own colour, so you can see how ideas connect across vaults. Local shows only what is near the open note, and switches add tags, notebooks and sources.

Canvas

The Studio's Canvas tool is a board of cards joined by arrows. Add text cards, note cards and web links, drag a card's dot onto another card to join them, and give arrows labels. A canvas downloads as a .canvas file in the open JSON Canvas format.

The Studio's Notes tile opens the notes written from that notebook.

Keyboard shortcuts

Press ? on the notes page to see every shortcut.

ActionKeys
New note⌘N
Quick switcher⌘O
Search all notes⇧⌘F
Switch editing and reading⌘E
Graph⌘G
Back and forward⌥⌘← and ⌥⌘→
Bold, italic, highlight⌘B, ⌘I, ⇧⌘H
Insert a link⌘K
Toggle a checkbox⌘L
Open the link under the cursor⌘Enter

Chat and citations

Ask questions about your sources in better-vault and get answers with numbered citations, or switch to Web mode to let the model search the internet for you.

Skills and MCP for AI agents

Keep shared SKILL.md instructions in a better-vault vault and let AI agents like Claude Code, Cursor and Codex read your notebooks and notes through MCP.

On this page

Write a noteLink notes, notebooks and sourcesBacklinks and the graphCanvasKeyboard shortcuts