productivity

Markmap▌

by jinzcdev

Markmap transforms Markdown into interactive mind maps with zoom, expand/collapse, and exports for visualizing structure

Transforms Markdown documents into interactive mind maps with zooming, node expansion/collapse, and multi-format export capabilities for visualizing hierarchical information.

github stars

★ 183

GitHub npm

Interactive zooming and node manipulationMulti-format export optionsOne-click browser preview

best for

/ Visualizing document structure and hierarchies
/ Creating presentation materials from Markdown notes
/ Organizing and reviewing complex information
/ Converting documentation into visual formats

capabilities

/ Convert Markdown text to interactive mind maps
/ Export mind maps as PNG, JPG, or SVG images
/ Zoom and navigate through mind map nodes
/ Expand and collapse mind map sections
/ Copy original Markdown content
/ Open mind maps in browser preview

what it does

Converts Markdown documents into interactive mind maps that you can zoom, expand/collapse, and export as images.

about

Markmap is a community-built MCP server published by jinzcdev that provides AI assistants with tools and capabilities via the Model Context Protocol. Markmap transforms Markdown into interactive mind maps with zoom, expand/collapse, and exports for visualizing structure It is categorized under productivity.

how to install

You can install Markmap in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Markmap is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Markmap MCP Server

Markmap MCP Server is based on the Model Context Protocol (MCP) that allows one-click conversion of Markdown text to interactive mind maps, built on the open source project markmap. The generated mind maps support rich interactive operations and can be exported in various image formats.

🎉 Explore More Mind Mapping Tools

Try MarkXMind - An online editor that creates complex mind maps using simple XMindMark syntax. It supports real-time preview, multi-format export (.xmind/.svg/.png), importing existing XMind files. Try it now!

Features

🌠 Markdown to Mind Map: Convert Markdown text to interactive mind maps
🖼️ Multi-format Export: Support for exporting as PNG, JPG, and SVG images
🔄 Interactive Operations: Support for zooming, expanding/collapsing nodes, and other interactive features
📋 Markdown Copy: One-click copy of the original Markdown content
🌐 Automatic Browser Preview: Option to automatically open generated mind maps in the browser

Prerequisites

Node.js (v20 or above)

Installation

Installing via Smithery

To install Markmap MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude

Manual Installation

# Install from npm
npm install @jinzcdev/markmap-mcp-server -g

# Basic run
npx -y @jinzcdev/markmap-mcp-server

# Specify output directory
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory

Alternatively, you can clone the repository and run locally:

# Clone the repository
git clone https://github.com/jinzcdev/markmap-mcp-server.git

# Navigate to the project directory
cd markmap-mcp-server

# Build project
npm install && npm run build

# Run the server
node build/index.js

Usage

Add the following configuration to your MCP client configuration file:

{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jinzcdev/markmap-mcp-server"],
      "env": {
        "MARKMAP_DIR": "/path/to/output/directory"
      }
    }
  }
}

[!TIP]

The service supports the following environment variables:

MARKMAP_DIR: Specify the output directory for mind maps (optional, defaults to system temp directory)

Priority Note:

When both the --output command line argument and the MARKMAP_DIR environment variable are specified, the command line argument takes precedence.

Available Tools

markdown-to-mindmap

Convert Markdown text into an interactive mind map.

Parameters:

markdown: The Markdown content to convert (required string)
open: Whether to automatically open the generated mind map in the browser (optional boolean, default is false)

Return Value:

{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_OF_MINDMAP_FILEPATH"
    }
  ]
}

License

This project is licensed under the MIT License.