Markdown是一种轻量级纯文本标记语言，由John Gruber于2004年设计。它使用简洁的符号语法（如井号、星号、短横线等）对文本进行格式标注，可被工具转换为HTML等富文本格式。Markdown广泛应用于文档编写、技术博客、内容管理系统及代码托管平台，以易读易写、源文件可读性强为核心特征。
使用标准 Markdown 作为内容层可将内容与展示解耦，降低供应商锁定（Vendor Lock-in）风险和框架迁移成本
纯 Markdown 文件适合版本管理，可放进 Git 仓库与代码一同演进，通过 Pull Request 审查和 CI/CD 管道构建部署，降低文档维护成本
OpenSpec不需要API Key，纯Markdown存储在代码仓库里
Hermes Agent将操作流程外化为可读写的Markdown文件来实现运行时的能力扩展
OpenAI GPT系列模型对Markdown格式特别友好，因为训练过程中大量接触了GitHub上以Markdown为主要格式的代码和文档
Claude在Markdown中用ASCII画图时经常出现对齐错误，边框偏移、行数不对等问题
HTML的diff极其嘈杂难以审查，是HTML替代Markdown的最大缺点
一个典型的HTML文档相比等效的Markdown内容可能多消耗2-5倍的token
HTML的diff极其嘈杂难以审查，是HTML替代Markdown的最大缺点
85%已验证OpenAI GPT系列模型对Markdown格式特别友好，因为训练过程中大量接触了GitHub上以Markdown为主要格式的代码和文档
65%待验证Hermes Agent将操作流程外化为可读写的Markdown文件来实现运行时的能力扩展
60%待验证OpenSpec不需要API Key，纯Markdown存储在代码仓库里
60%待验证Claude在Markdown中用ASCII画图时经常出现对齐错误，边框偏移、行数不对等问题
60%待验证一个典型的HTML文档相比等效的Markdown内容可能多消耗2-5倍的token
60%待验证纯 Markdown 文件适合版本管理，可放进 Git 仓库与代码一同演进，通过 Pull Request 审查和 CI/CD 管道构建部署，降低文档维护成本
50%待验证使用标准 Markdown 作为内容层可将内容与展示解耦，降低供应商锁定（Vendor Lock-in）风险和框架迁移成本
50%