🧠 Md2Mindmap - Markdown 思维导图工具
一句话介绍： 将 Markdown 文档一键转换为可交互的思维导图，支持 HTML + PDF 输出！
为什么需要 Md2Mindmap？
| 痛点 | Md2Mindmap 解决方案 |
|---|---|
| ❌ Markdown 只有文字，不够直观 | ✅ 一键生成可视化思维导图 |
| ❌ 整理思路效率低 | ✅ 自动识别层级结构 |
| ❌ 分享给别人看不懂 | ✅ HTML 可交互，PDF 可分享 |
| ❌ 没有合适的思维导图工具 | ✅ Markdown 写完自动生成 |
谁需要使用？
| 用户类型 | 使用场景 | 价值 |
|---|---|---|
| 学习者 | 整理知识、复习笔记 | 知识可视化 |
| 讲师 | 课堂演示、培训材料 | 直观展示 |
| 知识工作者 | 方案梳理、项目规划 | 提升效率 |
| 写作者 | 大纲整理、思路梳理 | 写作辅助 |
核心功能
✅ Markdown 解析
| 支持 | 说明 |
|---|---|
| 标题层级 | # ## ### #### 自动识别 |
| 列表 | - * 无序列表 |
| 表格 | 表格内容自动转换为节点（v1.1.0新增） |
| 嵌套 | 缩进自动识别 |
✅ 输出格式
| 格式 | 说明 |
|---|---|
| HTML | 可交互思维导图（推荐） |
| 适合打印、分享 |
✅ 交互功能
| 功能 | 说明 |
|---|---|
| 缩放 | 鼠标滚轮缩放 |
| 拖拽 | 拖动查看 |
| 展开/折叠 | 点击节点展开 |
| 暗色主题 | 自动检测系统主题 |
快速开始
安装
# 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 | Word 文档 | 文档提交、公文写作 |
| Md2Mindmap | 思维导图 | 知识整理、演示展示 |
安装 Md2docx：
clawhub install md2docx
更新日志
v1.1.0 (2026-03-27)
- ✅ 新增表格解析支持
- ✅ 表格内容自动转换为思维导图节点
- ✅ 支持表格多列内容层次化展示
v1.0.0 (2026-03-26)
- 🎉 首次发布
- ✅ Markdown 转 HTML 思维导图
- ✅ PDF 输出支持
- ✅ 交互功能（缩放、拖拽、展开/折叠）
许可证
MIT License
作者
OpenClaw Team
让思维可视化，从 Markdown 开始！ 🧠