| name | mindm-export |
| description | Export MindManager mindmaps to Mermaid, Markmap, Markdown, JSON, or YAML (HTML or data-only). Use when output must be generated or streamed, or when a map must be opened. |
| version | 1.0.0 |
| requires | ["mindm","pyyaml (optional, for yaml export)"] |
| platforms | ["macos","windows"] |
Mindm Export
Overview
Export the current MindManager map to HTML or data-only output. Preferred
one-liner is uvx (no install). Also available via mindm-export or
python -m mindmap.export. Choose mermaid_html, markmap_html,
markdown_html, or the data-only mermaid, markmap, markdown,
json, yaml.
Quick start
Run an export and open it (recommended, no install):
uvx --from mindm mindm-export --type mermaid_html --open
Run an export and open it (installed console script):
mindm-export --type mermaid_html --open
Run via the module entry point (source checkout):
python -m mindmap.export --type json --output /tmp/mindmap.json
Stream HTML to stdout:
mindm-export --type markmap --stream
Write to a specific file path:
mindm-export --type markdown_html --output /tmp/mindmap.htm
Notes
- Keep MindManager open with the target map active before running the CLI.
- For macOS access, use
--macos-access applescript (default) or --macos-access appscript.
- For deeper flag and behavior details, read references/cli.md.
Troubleshooting
| Problem | Solution |
|---|
| "No active document" error | Open a map in MindManager before running the CLI |
| Empty response or timeout | Ensure MindManager is responsive (not showing a modal dialog) |
| Permission denied (macOS) | Grant Accessibility permissions to Terminal/IDE in System Settings → Privacy & Security |
pyyaml import error | Install with pip install pyyaml or use a different --type |
--open does nothing | Check default application association for the output file type |
| HTML renders blank | Ensure the map has content; check browser console for JavaScript errors |