mindmap

# 思维导图（Markdown → 脑图） > 把 Markdown 大纲渲染成可交互思维导图 HTML，可选导出 PNG。走 `skills/shared/scripts/mindmap.py` > （markmap）。 > 数据图表见 chart-visualization；信息图/流程图见 infographic；本 SKILL 专做**层级大纲脑图**。 ## 输入 Markdown 大纲（用标题 `#`/`##`/`###` 表示层级，`-` 列表表示叶子）： ```markdown # 中心主题 ## 分支一 - 要点 A - 要点 B ## 分支二 - 要点 C ``` ## 输出（`outputs/主题名/`） - 思维导图 HTML（单文件；markmap JS 走 CDN，联网可交互展开/折叠，离线打开不可交互） - 可选 PNG 图片（`--png`） ## 执行 脚本路径（相对项目根）：`skills/shared/scripts/mindmap.py`（`make -h`）。 ```bash # 先把内容整理成 Markdown 大纲（你来做），存为 outline.md，再： python skills/shared/scripts/mindmap.py make -i outline.md \ -o outputs/主题名/mm.html --png ``` `-i -` 可从 stdin 读；`--title` 自定义标题；`--bg` 背景色。 ## 用法要点 1. **先把内容组织成清晰的 Markdown 大纲**（层级分明、每节点简短）——这是脑图质量的关键， 由你（LLM）完成：从文章/主题提炼中心 → 分支 → 要点。 2. 层级建议 2-4 层，节点文字精炼（几个字），别把整句话塞进节点。 3. HTML 可交互（展开/折叠、缩放），适合分享或嵌入；PNG 适合直接发图。 ## 前置（PNG） PNG 渲染需 playwright + chromium + 外网（markmap JS 走 CDN）。仅要 HTML 则无额外依赖。 ## 规则 1. 内容先成 Markdown 大纲再渲染，不要把无结构的长文直接丢进去。 2. 节点简洁；层级不宜过深（超过 4 层可读性差）。 3. 产物统一进 `outputs/主题名/`。 ## 参考来源 markmap（Markdown → 交互式思维导图）是开源标准方案；本 SKILL 生成自包含 HTML（CDN 加载 markmap），并用 Chromium 无头渲染导出 PNG。