MindMark

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.

What you can write: see a concrete outline in sample-mindmap.md (copy into a .md file and run MindMark: Open to explore it as a map—headings and nested lists are all you need).

Requirements

• Visual Studio Code 1.85.0 or newer, or another VS Code–compatible editor that supports this extension’s manifest (for example VSCodium or Cursor—install the same package from the Visual Studio Code Marketplace, Open VSX, or your product’s equivalent).

Getting started

1. Open a .md file (or create one).
2. Run MindMark: Open from the editor title bar when editing Markdown, or use the Explorer context menu on a .md file.
3. Edit structure by adding nodes, renaming, dragging, and using the in-editor menus.
4. 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 (and the Features tab)

In the Extensions side bar, MindMark’s Features tab is generated from the extension manifest: it lists contributed commands and configuration keys with their short titles. It does not show long marketing descriptions—those live here.

Commands (what they do in practice)

• MindMark: Open — Opens the active Markdown file in the MindMark webview 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, PDF, depending on build).
• 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:

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.

メンテナ向け: リリース手順

1. CHANGELOG.md と package.json の version を揃える。
2. 推奨検証: npm run typecheck:webview → npm run lint → npm test
3. 配布用 .vsix まで作る: npm run release
   • リポジトリルートに mindmark-<version>.vsix が出力される（例: mindmark-0.11.4.vsix）。
   • *.vsix は .gitignore 済みなので Git にはコミットしない。インストール確認は VS Code の「VSIX からインストール」などで行う。
4. Marketplace 向け公開は vsce publish 等、利用中のチャネル手順に従う。

npm スクリプトの違い

build:release に package を組み込まない理由: CI ではコンパイル・バンドルの検証だけ行い、vsce パッケージは重い・別用途であることが多いため。

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.