用途:把带标题层级的 Markdown 文件转换为可交互的 HTML 思维导图,适合将笔记或大纲可视化。输入为使用 # ## ### #### 层级的 Markdown,输出为内嵌全部资源、可离线使用的自包含 HTML;该技能是纯转换器,不依赖 LLM 或 API 密钥。
主要能力:默认仅展开第一层,降低复杂导图的认知负担,可逐节点手动展开;右上角控制面板提供“导出 PNG”和“导出 HTML”按钮,分别下载高质量图片和独立网页;点击节点文字(非分支圆圈)会在底部面板生成讨论提示,可复制到剪贴板或关闭,点击圆圈仅展开或折叠;支持鼠标滚轮缩放、拖拽平移、点击圆圈展开折叠、响应式布局。通过 Markmap 的 KaTeX 插件,标题内的 LaTeX 行内公式($...$)和块级公式($$...$$)会自动渲染,字面美元符号需转义为 $;存在公式时会在输出 HTML 旁生成 fonts/ 文件夹。
使用方式:先在 skills/mindmap 目录执行 pip install -r requirements.txt(仅依赖 loguru),并确保有 Node.js/npx 用于 markmap-cli(首次使用自动执行 npx -y markmap-cli)。然后在 skills/mindmap 目录运行 python main.py -i mindmap.md -o mindmap.html,其中 --input/-i 为必填输入文件,--output/-o 默认 mindmap.html。生成的 HTML 用浏览器打开即可交互。与智能体配合时,应要求其只输出标题层级、不用项目符号或编号列表、标题保持简练,再对生成文件执行上述转换命令。
限制:资料未说明对非标题格式、超大文件、具体浏览器版本或移动端表现的支持范围;提示文案为中文模板,可在 main.py 第 204 行修改,示例代码以资料为准。