Draft · 公开制定中人与 AI，
人与 AI，
以各自的方式处理同一份知识。
Mindmap Markdown 是一种往返稳定（round-trip stable）的 Markdown 规范（profile），让人与 AI 能以各自的表达方式处理同一份知识。
一种同时服务于人和机器的文档格式，需要具备四个条件
Markdown 满足前三个。最后一个只在文档层级较浅时才成立。
开放标准
任何人都可使用和实现
✓ Markdown
机器可读
解析器可准确解析
✓ Markdown
AI 可读
LLM 可直接读取
✓ Markdown
人类可读
仅在层级较浅时
● 深度 1–2● 3–4● 5+
把它画成树很容易。
无损地转换回来却很难。
层级一旦变深，人就无法从纯文本中看出结构，而同样的结构画成树却一目了然。可是当 LLM 重写文档时，下列信息会悄无声息地丢失，而目前还没有任何标准把这当作问题。
节点标识人工批注布局审阅记录
无需安装的单个 HTML，两种视图
Mindmap Markdown 文档可渲染为一个无需安装任何东西的单一 HTML 文件，其查看器同时提供思维导图和大纲两种视图。因为没有哪一种视图能适应所有规模。
思维导图
一眼看清形状层级深时更有优势大纲
可逐项浏览的顺序节点多时更有优势一致性级别
级别是累积的。实现需声明其所主张的最高级别。
L0Read
符合规范的文档就是普通的 Markdown，在现有所有 Markdown 工具中都能保留层级。
● 所有 Markdown 工具
L1Structure
文档 → 树（lift）与树 → 文档（canonical projection）各自唯一确定，并互为逆运算。
● 已在 mindmapmd 中实现
L2Round-trip
树之间的结构化 diff 与 merge，以及脱离整篇文档单独处理子树。
● 规则尚未编写
设计原则
依然是 Markdown
可在 GitHub、Obsidian 等你正在使用的编辑器中直接打开，采用成本从零开始。
语义在文档中，呈现在旁边
布局和样式放在 sidecar 中，绝不放入发送给模型的文本。
可验证的一致性
无法检验的规范只是建议。规范与测试由同一来源生成。
互操作优先于竞争
优先为 OPML、JSON Canvas、markmap 等现有格式开发适配器。
代码仓库
spec公开
规范及其规范性示例
mindmapmdL1
参考实现：lift 与 canonical projection
conformance计划中
测试套件、运行器和实现登记
adapters计划中
与 OPML、JSON Canvas、markmap 的互操作