Md2mindmap

Markdown 转思维导图工具 - 一键生成可交互思维导图，支持 HTML + PDF 输出！

Security Scan

The skill's code, instructions, and requirements are consistent with its description (Markdown → interactive mindmap HTML, optional PDF via Playwright); it requests no unrelated credentials and has no obvious mismatches.

Purpose & Capability

Name/description (Markdown to mindmap, HTML/PDF) matches the provided Python script and SKILL.md. Only required binary is python and Playwright is only suggested for PDF output—both appropriate for the stated functionality.

Instruction Scope

Runtime instructions stay on-task: parse Markdown, generate HTML that references markmap/d3 from public CDNs, and optionally use Playwright to render the local HTML to PDF. The code reads only the provided input file(s) and writes output files; it does not access environment variables, other system credentials, or external endpoints beyond standard CDN usage by the generated HTML.

Install Mechanism

No install spec in the registry; SKILL.md recommends pip install playwright and playwright install chromium for PDF generation, which is the normal and expected install path. No downloads from unknown personal servers or URL shorteners are present in the package.

Credentials

The skill requests no environment variables or credentials. The only extra runtime requirement (Playwright + Chromium) is proportional to the optional PDF feature.

Persistence & Privilege

Flags are default (always: false, agent invocation allowed). The skill does not request permanent platform presence, nor does it modify other skills or system-wide configs.

Assessment

This skill appears coherent and limited to converting Markdown into an interactive HTML mindmap and optionally a PDF. Before installing: (1) note PDF export requires Playwright and downloading a Chromium browser (playwright install chromium), (2) the generated HTML loads JS/CSS from public CDNs (unpkg) when rendered in a browser or by Playwright, so opening files will cause outbound CDN requests, and (3) as with any tool that renders user-provided input into HTML/JS, avoid running it on untrusted Markdown without reviewing content if you worry about injection risks. If you need extra assurance, run the script in a sandboxed environment and review markmap_generator.py locally (it is included).

🧠 Md2Mindmap - Markdown 思维导图工具

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

---

为什么需要 Md2Mindmap？

痛点	Md2Mindmap 解决方案
❌ Markdown 只有文字，不够直观	✅ 一键生成可视化思维导图
❌ 整理思路效率低	✅ 自动识别层级结构
❌ 分享给别人看不懂	✅ HTML 可交互，PDF 可分享
❌ 没有合适的思维导图工具	✅ Markdown 写完自动生成

---

谁需要使用？

用户类型	使用场景	价值
学习者	整理知识、复习笔记	知识可视化
讲师	课堂演示、培训材料	直观展示
知识工作者	方案梳理、项目规划	提升效率
写作者	大纲整理、思路梳理	写作辅助

---

核心功能

✅ Markdown 解析

支持	说明
标题层级	# ## ### #### 自动识别
列表	- * 无序列表
表格	表格内容自动转换为节点（v1.1.0新增）
嵌套	缩进自动识别

✅ 输出格式

格式	说明
HTML	可交互思维导图（推荐）
PDF	适合打印、分享

✅ 交互功能

功能	说明
缩放	鼠标滚轮缩放
拖拽	拖动查看
展开/折叠	点击节点展开
暗色主题	自动检测系统主题

---

快速开始

安装

# 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 开始！ 🧠