🧠 Md2Mindmap - Markdown 思维导图工具

一句话介绍： 将 Markdown 文档一键转换为可交互的思维导图，支持 HTML + PDF 输出！

为什么需要 Md2Mindmap？

谁需要使用？

核心功能

✅ Markdown 解析

✅ 输出格式

✅ 交互功能

快速开始

安装

# ClawHub 安装（推荐）
clawhub install md2mindmap

# 或手动安装
git clone <repo-url> md2mindmap
cd md2mindmap
pip install playwright
playwright install chromium

使用

# 生成 HTML
python markmap_generator.py --file input.md --output output.html

# 生成 HTML + PDF
python markmap_generator.py --file input.md --output output.html --pdf output.pdf

使用案例

案例 1：学习笔记整理

场景： 学习 Python，整理知识结构

步骤：

# Python 学习笔记

## 基础语法
### 变量
### 数据类型
### 控制流

## 面向对象
### 类
### 继承
### 多态

python markmap_generator.py --file python-note.md --output python-mindmap.html

效果： 自动生成可交互思维导图，方便复习！

案例 2：培训课程大纲

场景： 准备企业培训课程

步骤：

# AI 办公培训

## 第一天
### AI 基础概念
### 常用工具介绍

## 第二天
### 实操演练
### 案例分析

## 第三天
### 企业应用
### 效率提升

python markmap_generator.py --file training.md --output training.html --pdf training.pdf

效果： 课堂演示 HTML，课后发 PDF！

案例 3：项目规划

场景： 新项目启动，梳理架构

步骤：

# 项目架构

## 前端
### Vue3
### TypeScript

## 后端
### Python FastAPI
### PostgreSQL

## 部署
### Docker
### CI/CD

python markmap_generator.py --file architecture.md --output architecture.html

效果： 团队快速理解项目架构！

输出示例

HTML 思维导图

可交互思维导图

特点：
- ✅ 可缩放、拖拽
- ✅ 节点可展开/折叠
- ✅ 自动适应屏幕
- ✅ 暗色主题支持

PDF 输出

A4 横向 PDF

特点：
- ✅ 适合打印
- ✅ 方便分享
- ✅ 高清输出

常见问题

Q1: 支持哪些 Markdown 语法？

回答： 支持标题层级（# ## ### ####）、无序列表（- *）和表格（v1.1.0新增）

Q2: PDF 生成失败怎么办？

回答： 需要先安装 Playwright：

pip install playwright
playwright install chromium

Q3: 中文显示有问题吗？

回答： 完美支持中文，无乱码问题！

Q4: 可以自定义样式吗？

回答： 当前版本使用默认样式，后续版本支持自定义！

与 Md2docx 配合使用

同一个 Markdown，两种输出！

安装 Md2docx：

clawhub install md2docx

更新日志

v1.1.0 (2026-03-27)

• ✅ 新增表格解析支持
• ✅ 表格内容自动转换为思维导图节点
• ✅ 支持表格多列内容层次化展示

v1.0.0 (2026-03-26)

• 🎉 首次发布
• ✅ Markdown 转 HTML 思维导图
• ✅ PDF 输出支持
• ✅ 交互功能（缩放、拖拽、展开/折叠）

许可证

MIT License

作者

OpenClaw Team

让思维可视化，从 Markdown 开始！ 🧠