Everything it does, and the keys to drive it.
MindmapMD is one focused thing: a VS Code editor that opens any .md file as a live mindmap and keeps the map and the Markdown in step. It is free and runs entirely on your machine. Below is the whole of it — what a map can hold, and every shortcut that moves it.
-
Any
.mdopens as a mindmapHeadings become branches and list items become leaves, laid out automatically. No import and no conversion — you are looking straight at the file.
-
Edits sync both ways
Change the map and the Markdown updates; change the text and the map follows. Edits from another pane, a script, or an AI assistant appear as they land.
-
The file is the source of truth
Every change writes back to the plain
.mdand saves at once. No sidecar database, no proprietary format — what you see is what is on disk. -
Flip between map and source
Switch the same file between the mindmap and the raw Markdown from the editor title bar — one document, shown two ways, never a copy that can drift.
-
A title at the centre
When a note has a single top-level
#heading, it becomes the centre node, so the map opens around its subject instead of an empty root. -
Frontmatter is preserved
YAML frontmatter at the top of the file is kept verbatim through every edit, so tags and metadata your other tools rely on survive untouched.
Nodes are real Markdown, so they render the Markdown you already write — right inside the map.
-
Formatting & links
Bold and italic render in place, and
[text](url)links are clickable straight from a node. -
To-do checkboxes
A
- [ ]or- [x]item becomes a checkbox you can tick on the node — tasks live in the same map as your thinking. -
Inline images
Local images embedded in a node show inline; click to open them full size. Obsidian-style
alt|widthsizing hints are honoured. -
Code blocks
Fenced code blocks attach to their heading and render as a formatted code panel inside the node — snippets stay where they belong.
-
Mermaid diagrams
A
```mermaidblock renders as a live diagram — flowcharts, sequences and more — themed to match, with click-to-zoom. -
Tables
GitHub-style pipe tables render as real tables inside a node, with a zoom view for the wide ones.
-
Math
LaTeX math renders with KaTeX, so formulae appear typeset rather than as raw
$…$source. -
Notes under a point
Indented prose beneath a bullet is kept as that node’s body, so a leaf can carry a sentence of detail without cluttering the branch.
Select a node, then drive the whole map without reaching for the mouse.
Editing
- Tab
- Add a child to the selected node
- Enter
- Add a sibling (a child, on the centre node)
- Space / F2
- Edit the selected node
- Enter / Esc
- While editing: save / cancel (Shift+Enter for a line break)
- T
- Cycle the to-do state: none → ☐ → ☑
- \
- Collapse or expand the branch
- Delete / Backspace
- Delete the selection
Moving & selecting
- ↑↓←→
- Move between nodes
- Shift+↑↓←→
- Extend the selection along that path
- Ctrl / ⌘+A
- Select every node, collapsed branches included
- Shift / ⌘+click
- Add or remove a node from the selection
- Drag empty space
- Marquee-select a box of nodes
Clipboard
- Ctrl / ⌘+C
- Copy the selected nodes as Markdown
- Ctrl / ⌘+X
- Cut the selected nodes
- Ctrl / ⌘+V
- Paste Markdown in as child nodes
View & mouse
- F
- Fit the whole map in view
- 0
- Reset to 100% and centre on the root
- + / −
- Zoom in / out
- Scroll
- Pan the canvas (or right-drag)
- Ctrl / ⌘+scroll
- Zoom to the cursor (or pinch to zoom)
- Drag a node
- Re-parent or re-order it; the Markdown follows
Shortcuts act on the current selection and pause while you are typing in a node.
-
Local-first, fully offline
No account, no sign-in, no network calls, no telemetry. The extension never sends your Markdown anywhere. See the privacy policy.
-
Works with your tools
It is plain Markdown: commit it to git, open it in any editor, and let Claude Code or Copilot read and write it directly — the map just stays in sync.
-
Recolour to taste
One considered theme out of the box, nothing to configure. A small control re-tints the five branch colours to match your brand, with one click to reset.
-
Cross-platform
Runs wherever VS Code does — Windows, macOS and Linux, on version 1.85 or newer. One install, the same map everywhere.
Open a map
Set .md to open as a mindmap by default, use the toggle in the editor title bar, or right-click a file in the Explorer → Open as Mindmap.
Commands
Open as Mindmap · Switch to Markdown Source · New Mindmap — all from the Command Palette.
By design No settings maze, no proprietary export, no clutter. The shortest set of features that does the job — less, by design.