MindMark is a Mind Map editor for Markdown (.md) in VS Code and compatible editors. Edits map back to ordinary Markdown—headings and nested lists—so your notes stay portable and diff-friendly.
Why Markdown?
MindMark persists your map as plain Markdown on purpose. Structure expressed with headings and nested lists is easy for people to read, works cleanly with Git and diffs, and is straightforward for AI systems to interpret—models and assistants already treat Markdown reliably, so the same file travels well into chats, retrieval workflows, or automation without a proprietary save format.
You keep a Mind Map view for thinking in the editor while the .md on disk stays a portable, AI- and tooling-friendly source of truth. Use the editor and MindMark side by side: map nodes mirror headings and nested lists in the file.
Requirements
- Visual Studio Code 1.85.0 or newer, or another VS Code–compatible editor (for example VSCodium or Cursor—install the same package from the Visual Studio Code Marketplace, Open VSX, or your product’s equivalent).
Getting started
- Open a
.mdfile (or create one). - Run MindMark: Open from the editor title bar when editing Markdown, or use the Explorer context menu on a
.mdfile. - Edit structure by adding nodes, renaming, dragging, and using the in-editor menus.
- Changes can sync live to the Markdown document (default), depending on settings.
Create a new Markdown file ready for MindMark with MindMark: New File from the Explorer context menu.
Features
In the Extensions view, the Features tab lists MindMark’s commands and configuration names as short titles.
Commands (what they do in practice)
- MindMark: Open — Opens the active Markdown file in MindMark so you can edit the same document as a Mind Map.
- MindMark: New File — Creates a new Markdown file via the save dialog and opens it in MindMark (avoids leaving you on an unsaved Untitled buffer).
Editor capabilities
- Visual Mind Map for outline structure derived from Markdown headings and nested list items.
- Two-way editing with optional live sync: map → Markdown and Markdown → map (toggle in settings or the in-app menus).
- Drag-and-drop and keyboard shortcuts for restructuring nodes.
- Export from the File menu inside MindMark (PNG, JPEG, SVG, and PDF when available).
- Memos and tables, plus Visual / Markdown workflows where available.
- UI language for Mind Map chrome and menus (Japanese, English, and more).
Settings (mindmap.*)
Search Mindmap in VS Code Settings to find these keys:
| Setting | What it does |
|---|---|
mindmap.liveSync |
Push Mind Map edits to the Markdown file in real time. |
mindmap.syncMarkdownToMindmap |
Pull Markdown edits into the Mind Map in real time. |
mindmap.listMarker |
Default list bullet style (-, *, or 1.). |
mindmap.uiLanguage |
Language of labels and menus inside MindMark. |
mindmap.followVscodeColorTheme |
When on (default), MindMark’s light/dark chrome follows VS Code’s active color theme. When off, use the theme selected from MindMark’s View menu only. |
mindmap.indentSize / mindmap.tabSize |
Indent and tab width used when reading/writing structure. |
Other toggles control blank lines around headings, memo panel width, on-screen hints, and optional label wrapping.
Bugs and feedback
Found a bug or want to suggest an improvement? Please open an issue on GitHub. Include what you expected, what happened, and steps to reproduce—or attach a small .md sample—whenever you can; it makes fixes much faster.
On the Visual Studio Code Marketplace, you can use Q & A for quick questions. On Open VSX, use the listing’s discussion or review area if available.
Troubleshooting (map stops responding after adding a node)
Sometimes the Mind Map stops responding right after you add a node—for example arrow keys or add-node shortcuts do nothing until you reload the view.
If you see this, please report it on GitHub. We rely on these reports to improve MindMark. Brief steps (what you clicked, confirm with Enter, autosave), whether mindmap.liveSync and mindmap.syncMarkdownToMindmap are on, and your MindMark version all help.
To get working again in the meantime, try:
- Close MindMark and run MindMark: Open on the same file again.
- Temporarily turn off
mindmap.syncMarkdownToMindmapin Settings and see if the problem still happens when you edit the Markdown file and the map at the same time.
License
Proprietary — see the LICENSE / license text included in this extension package. Installation and use are permitted under that end-user license when you obtain MindMark through the Visual Studio Code Marketplace, Open VSX, or another channel explicitly named as authorized in that license.