# Markmap
> Transforms Markdown documents into interactive mind maps with zooming, node expansion/collapse, and multi-format export capabilities for visualizing hierarchical information.
Canonical: https://www.mcpfolio.com/servers/markmap
Last updated: 2026-10-28
## Catalog record

- Publisher: jinzcdev
- Categories: productivity

## Repository

https://github.com/jinzcdev/markmap-mcp-server

## Transports

stdio

## Authentication

No credentials were configured; the tested read-only tool “list_mindmaps” succeeded in an isolated environment. Other tools may have additional requirements.

## Tools

- **markdown_to_mindmap**: Convert structured Markdown (headings # and nested lists -) into an interactive mind map HTML file, with optional server-side PNG/JPG/SVG export.

Use when the user wants a visual mind map/outline of structured content (architecture, plans, notes, hierarchies), or asks to visualize / mindmap / diagram. Do not use for flat unstructured text (restructure first), or to list/read existing outputs (use list_mindmaps / get_mindmap).

Behavior:
- WRITES files under the configured output dir. HTML is always written; image formats write an extra file. Reusing filename overwrites.
- html is fast (<1s). png/svg/jpg launch headless Chromium via Playwright (5–15s; requires: npm install playwright && npx playwright install chromium).
- Local only — no external APIs or third-party keys. Open mode=never: The server never opens the browser.
- Offline=false (server config).

Response:
- JSON {"htmlFilePath":"<path>","filePath":"<path>"} — htmlFilePath is always the HTML source; filePath is the primary a
- **list_mindmaps**: List markmap* files (html/png/jpg/jpeg/svg) in the output directory, newest first. Read-only — no side effects. Missing/empty dirs return {"files":[]}.

Returns: {"outputDir","files":[{"name","filePath","size","mtimeMs","mtime"}]} (mtime is ISO 8601).

Use before get_mindmap to discover paths, or before cleanup_mindmaps to preview targets. Not for generating new mind maps (use markdown_to_mindmap).
- **get_mindmap**: Retrieve a generated mind map file by absolute path. Read-only — no side effects. Only paths inside the configured output directory are allowed (path traversal denied).

Returns JSON {"filePath","mimeType","size"}. For text/html or image/svg+xml under 200KB, also appends a text content block. PNG/JPG return metadata only (no image block) — re-export via markdown_to_mindmap with format=png|jpg if the agent needs pixels.

On error: isError:true with {"error":"Failed to retrieve mind map","message"}.

Use list_mindmaps first to obtain a valid filePath. Prefer this over regenerating when the file already exists.
- **cleanup_mindmaps**: Permanently delete markmap* files from the output directory. DESTRUCTIVE and irreversible when dryRun is false.

dryRun defaults to false — omitting it WILL delete. Always call once with dryRun=true to preview, then again with dryRun=false to commit. Prefer list_mindmaps beforehand.

Returns {"deleted":["<path>",...],"kept":<n>}; dryRun responses also include dryRun:true and do not delete.

Use instead of manual file deletion when pruning old generated mind maps.

## Sources

- [MCP.Directory public profile](https://mcp.directory/servers/markmap)
- [Linked publisher repository](https://github.com/jinzcdev/markmap-mcp-server)
- [npm registry metadata](https://registry.npmjs.org/%40jinzcdev%2Fmarkmap-mcp-server)
- [maintainer_repository_documentation](https://github.com/jinzcdev/markmap-mcp-server)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/markmap) to view instructions for each supported client.