SuperAPI AI 工具集

markmind-exporter

办公与效率

查看项目

更新于 10-15 09:52

技能介绍

MarkMind Exporter 是一个用于将思维导图 JSON 大纲渲染为 Obsidian MarkMind Rich 格式文件的技能。它的目标是把预先构建好的思维导图 JSON 结构转换为一个 .md 文件,用户可以直接将其放入 Obsidian 库中,并使用 MarkMind 插件打开。

用途

该技能用于把思维导图数据导出为 Obsidian 中 MarkMind 插件可识别的富文本格式。它本身不负责生成思维导图内容,而是接收已有的 JSON 大纲并完成格式转换与渲染。

输入格式

输入是一个 JSON 文件,采用标准思维导图大纲格式,包含 root(根节点文本)和 branches(分支数组)。每个分支可包含 text、color 和 children 字段,children 可继续嵌套子节点。示例结构如下:

{ "root": "🎯 Central Theme", "branches": [ { "text": "🔴 Branch One", "color": "#ff6b6b", "children": [ { "text": "⚙️ Sub-concept A", "children": [ { "text": "Detail 1" }, { "text": "Detail 2" } ] } ] } ] }

工作流程

第一步:检查输入。如果没有可用的思维导图 JSON(没有文件路径、没有先前 generate-mindmap 的输出、对话中也没有内联 JSON),则先调用 learning:generate-mindmap 技能,根据用户主题或内容生成 JSON 大纲,然后继续第一步。

第二步:定位思维导图 JSON。找到思维导图大纲 JSON,可以是用户提供的文件路径、先前 generate-mindmap 调用的输出,或内联 JSON。

第三步:运行渲染器。将 JSON 大纲通过管道传给 scripts/generate_markmind.py,或从文件读取。命令示例如下:

cat <<'EOF' | python scripts/generate_markmind.py --output /path/to/output.md --max-depth 4 {...mindmap JSON...} EOF

或从文件:

python scripts/generate_markmind.py --input outline.json --output /path/to/output.md --max-depth 4

脚本会自动完成以下操作:生成唯一节点 ID;将分支分配到根节点的左右两侧;递归计算带适当间距的 x/y 坐标,支持任意深度;截断超过 --max-depth 的节点(默认值为 4);创建 8 个空白自由节点;将全部内容包装为合法的 MarkMind Rich 格式。

第四步:交付。将生成的 .md 文件呈现给用户,并说明它已可直接放入 Obsidian。

参考

如需完整的 MarkMind Rich JSON 模式,可阅读 references/markmind-rich-spec.md。

交付前检查清单

所有 pid 引用都指向已存在的 id 值;根节点具有 isRoot: true、main: true 和 layout 对象;根节点没有 pid;每个二级分支具有唯一的描边颜色;所有后代继承其二级祖先的描边;坐标不重叠(遵守 V_SPACING);JSON 合法(无尾随逗号、括号配对);存在 8 个空白自由节点;没有节点超过配置的最大深度。

适用场景

适用于需要将思维导图 JSON 大纲转换为 Obsidian MarkMind Rich 格式文件的场景,尤其是配合 generate-mindmap 技能生成大纲后,再导出为可直接在 Obsidian 中打开的文件。

限制

该技能依赖已有的思维导图 JSON 大纲;若没有输入,需要先调用 generate-mindmap 技能生成。渲染结果面向 Obsidian MarkMind 插件,其他平台或插件的兼容性暂未提供。