Marmimind
Interactive mindmap viewer and editor for Markdown files in VS Code, with Mermaid diagram support.
Features
- Markdown to Mindmap: Visualize markdown files as interactive mindmaps
- Mermaid Diagrams: Render mermaid diagrams within nodes (click to expand)
- Interactive Editing: FreeMind-like keyboard shortcuts for editing
- Bidirectional Sync: Cursor position syncs between editor and mindmap
- Read-only by Default: Safe viewing mode with optional edit toggle
- Export to HTML: Export self-contained interactive HTML files
- State Preservation: Maintains zoom, position, and fold state on edits
Installation
From VS Code Marketplace (recommended):
- Open VS Code
- Go to Extensions (
Ctrl+Shift+X)
- Search for "Marmimind"
- Click Install
Or install directly: Marmimind on VS Code Marketplace
Offline installation:
- Download
.vsix from Releases
- In VS Code, press
Ctrl+Shift+P → "Install from VSIX"
- Select the downloaded file
Usage
- Open any markdown file
- Press
Ctrl+Alt+M to open mindmap preview
- Use the toolbar or keyboard shortcuts to navigate and edit
| Button |
Action |
| + |
Zoom in |
| − |
Zoom out |
| Fit |
Fit mindmap to view |
| Expand |
Expand all nodes |
| Collapse |
Collapse all nodes |
| Edit |
Toggle edit mode (unchecked = read-only) |
Keyboard Shortcuts
Navigation (always available)
| Shortcut |
Action |
| ↑ |
Previous sibling (same level) |
| ↓ |
Next sibling (same level) |
| ← |
Parent node (saves position to history) |
| → |
Return from history, or first child |
| Home |
First sibling |
| End |
Last sibling |
| Escape |
Go to root node |
| Alt+PageUp |
Previous sibling |
| Alt+PageDown |
Next sibling |
Fold/Unfold (always available)
| Shortcut |
Action |
| Space |
Toggle fold current node |
| Tab |
Fold current node |
| Shift+Tab |
Unfold current node |
| Ctrl+Space |
Toggle fold all children |
| Alt+Home |
Collapse all (fold to root) |
| Alt+End |
Expand all |
Selection (always available)
| Shortcut |
Action |
| Click |
Select node |
| Shift+↑ |
Extend selection up |
| Shift+↓ |
Extend selection down |
| Shift+← |
Extend selection to parent |
| Shift+→ |
Extend selection to children |
| Modifier |
Action |
| Scroll |
Pan (default markmap behavior) |
| Ctrl+Scroll |
Zoom in/out |
| Shift+Scroll |
Navigate between siblings |
| Alt+Scroll |
Navigate up/down in tree |
Editing (requires Edit mode enabled)
| Shortcut |
Action |
| Insert |
Add child node |
| Shift+Insert |
Add parent node |
| Enter |
Add sibling node below |
| Shift+Enter |
Add sibling node above |
| Delete / Backspace |
Delete selected node |
| F2 |
Edit node text |
| Double-click |
Edit node text |
Move & Restructure (requires Edit mode)
| Shortcut |
Action |
| Ctrl+↑ |
Move node up |
| Ctrl+↓ |
Move node down |
| Ctrl+← |
Promote (decrease indent) |
| Ctrl+→ |
Demote (increase indent) |
| Drag & Drop |
Reorder or reparent nodes |
| Shortcut |
Action |
| Alt+Shift+B |
Toggle bold |
| Alt+Shift+I |
Toggle italic |
| Alt+Shift+S |
Toggle ~~strikethrough~~ |
| Ctrl+L |
Insert link (enter URL) |
| Alt+Shift+L |
Insert link (file picker) |
| Ctrl+Enter |
Follow link |
Configuration
| Setting |
Default |
Description |
marmimind.autoOpen |
false |
Auto-open mindmap for markdown files |
marmimind.syncScrolling |
true |
Sync cursor between editor and mindmap |
marmimind.defaultLayout |
right |
Panel position: right, below, active |
Mermaid Diagrams
Mermaid code blocks are rendered as diagrams within mindmap nodes.
Use triple backticks with mermaid language identifier:
```mermaid
flowchart TD
A[User] --> B[VS Code]
B --> C[Marmimind]
```
Click on a diagram to view it full-size in a modal.
Supported diagram types:
- Flowchart / Graph
- Sequence Diagram
- Class Diagram
- State Diagram
- ER Diagram
- Gantt Chart
- Pie Chart
- Journey
- Git Graph
- Mindmap
- Timeline
Development
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run watch
# Lint
npm run lint
# Package
vsce package
# Install locally
code --install-extension marmimind-0.0.1.vsix --force
License
MIT
| |
