AI时代文档之争：为什么我不建议普通人直接跟风切换HTML

最近，Anthropic Claude Code团队工程师Thariq在社交平台发布了一条关于文档格式选择的技术观点，迅速获得超过200万次浏览。他主张弃用Markdown，转而采用HTML作为AI协作文档的主要格式。这一观点得到了特斯拉前AI总监、OpenAI创始团队成员Karpathy的公开支持。一时间，圈内掀起了一股「HTML替代Markdown」的讨论热潮。然而，当我们冷静审视这场讨论时，一个关键问题浮出水面：这些来自头部AI公司的工程师级建议，真的适用于普通用户吗？

Markdown在AI协作全流程中的核心地位

在深入分析之前，我们需要先厘清Markdown在当前AI协作流程中的实际位置。从需求分析（research.md）到方案设计（plan.md），从任务拆解到最终文档输出，Markdown贯穿了人与AI协作的几乎所有环节。它不仅仅是 一种标记语言，更是人类与AI对齐认知、明确目标的桥梁。 以写作为例，从素材研究到大纲设计，从初稿撰写到修改迭代，整条工作流都以Markdown为载体。当Claude输出一份Markdown格式的结果时，用户可以直接拿来使用，效率极高。这种「输入-输出-使用」的零摩擦链路，正是Markdown在AI时代依然保持生命力的根本原因。

资源条件差异：别忽视隐藏的成本

Thariq的方案之所以有效，很大程度上依赖于他作为Anthropic内部员工的特殊身份。对他而言，token成本几乎可以忽略不计。然而，对普通用户而言，这个前提条件并不成立。技术社区的实测数据显示，HTML格式相比Markdown会多消耗2到4倍的token，生成速度也相应慢2到4倍。 更关键的是，切向HTML后，用户将失去与AI共同修改文档的能力。Markdown的最大优势不在于「简单」，而在于用户可以随时直接动手修改——两个词、一段话、一个章节，自己就能搞定。但HTML一旦生成，复杂的标签结构和嵌套关系让任何小改动都需要借助AI重写。这种「编辑自由度」的丧失，对需要反复调整的spec、计划和个人笔记而言，是致命的。

什么时候该选择HTML

这并不意味着HTML一无是处。格式选择的核心在于任务本身的需求。当你的任务更适合图形化、表格化、可交互的方式呈现时，HTML就是更优选择。 适用Markdown的场景包括：一步出结果的任务、个人笔记日常记录、AI中间过程文档、需要反复修改的spec和提示词模板。而HTML更擅长的场景则是：给非技术决策者看的报告、设计方案和原型展示、流程图和架构图、需要交互的数据整理工具。 一个值得推荐的中间策略是：用Markdown完成内容创作和中间稿，再让AI将其渲染为HTML做最终呈现。这样既保留了Markdown对大模型的友好度，又获得了HTML对人类的可读性。

三个容易踩的坑

在这场讨论中，Thariq本人也提出了警示：有的人读完帖子就立刻去做一个「/html skill」，这种做法并不可取。建议先在不同场景中每次从零prompt，沉淀出实际经验后再考虑模板化。 第二个坑是让HTML的视觉效果掩盖内容的薄弱。HTML输出往往色彩斑斓、结构清晰，容易让人沉浸在「成品感」中，而忽视了内容本身的质量。好看的废话仍然是废话，输出形态升级不应成为降低内容标准的借口。 第三个坑是忽视真实代价。HTML生成的token消耗更高、速度更慢，版本管理时的diff噪音也更大。并非每个任务都值得为「好看」付出这些代价。

如有侵权，请联系删除。