最近，Claude Code 团队成员 Thariq Shihipar 的一篇文章在开发者圈刷屏。
他的观点很简单，也很刺耳：HTML 正在成为新的 Markdown。
过去我们让 AI 写方案、写总结、写 PR 说明、写调研报告，默认都是 Markdown。因为它轻、好写、好复制。
但问题是：AI 写出来的 Markdown，越来越长，越来越密，最后没人读。
这才是真正的变化。不是 Markdown 不好，而是 AI 时代的内容形态变了。
| 不是 AI 不会写文档，而是我们还在用旧格式承接新速度。 |
01 以前我们喜欢 Markdown，是因为人要亲手写
Markdown 的优势很明显：简单、干净、通用、容易编辑。
在过去，这几乎是完美格式。程序员写文档，产品写需求，创业者写方案，所有人都能用最少的格式成本，把想法写下来。
但现在不一样了。
很多文档已经不是人一点点写出来的，而是 AI 一次生成几百行、上千行。产品方案、技术设计、代码 Review、调研报告、事故复盘、PR 说明，全都可以让 Agent 自动产出。
于是一个尴尬的问题出现了：AI 写得越多，人读得越少。
一份超过 100 行的 Markdown 文档，你真的会完整看完吗？大多数时候，我们只是扫几眼，然后继续让 AI 改。
这意味着 Markdown 最大的优势，“适合人类编辑”，正在被削弱。因为我们已经不太自己编辑了。我们更多是在看、判断、反馈，再让 AI 继续改。
| AI 时代，文档的核心任务已经从“方便写”，变成了“方便看懂”。 |
02 HTML 赢的不是格式，而是可读性
Thariq 选择 HTML，不是因为它更酷，而是因为它能承载更多信息。
Markdown 适合线性表达。但复杂工作不是线性的。
一个代码变更，里面有 diff、风险点、调用链、模块关系。一个产品方案，里面有用户路径、界面草图、取舍对比。一个调研报告，里面有图表、时间线、引用、结论和下一步行动。
这些东西塞进 Markdown，就会变成一堵文字墙。
但 HTML 可以把它变成表格、颜色标注、SVG 图示、交互组件、折叠区块、标签页、按钮、滑块、流程图。
你不是在读一篇文档。你是在打开一个可以浏览、比较、操作的工作台。
| Markdown 是文本。HTML 是界面。 |
03 真正值钱的，是让人重新跟上 AI 的速度
很多人用 AI 的痛点，不是 AI 不够快。
恰恰相反，是 AI 太快了。
它十几秒写出一份方案，几分钟改完一个模块，半小时生成一套复杂说明。然后人类开始落后。
你看不完它的计划，也跟不上它的推理，只能含糊地说：“继续。”
这很危险。因为一旦你不再读 AI 的输出，你就不再真正掌控工作。
HTML 的价值就在这里：它不是让 AI 写得更多，而是让人更容易看懂。
比如让 Claude Code 生成一个 PR Review 页面：左边是代码 diff，右边是风险说明；严重问题用红色，优化建议用黄色；关键逻辑画成流程图；不熟悉的模块加上跳转导航。
这比一大段 Markdown 评审意见更容易进入大脑。
| AI 时代最稀缺的能力，不是生成，而是理解生成结果。 |
04 HTML 特别适合这几类工作
第一类：方案探索。不要让 AI 只写一个方案。让它生成一个 HTML 页面，把 5 个方向并排摆出来：布局不同、取舍不同、成本不同、风险不同。你一眼就能比较。
第二类：代码 Review。让 AI 把 PR 变成一个可浏览页面。哪些文件变了，为什么变，风险在哪里，评审者应该重点看什么，都可以视觉化。
第三类：设计原型。按钮动画、交互流程、组件状态、主题色方案，用 Markdown 很难表达。但 HTML 可以直接跑起来。
第四类：研究报告。复杂概念可以用图、表、折叠说明、术语卡片来组织。这比一篇长文更适合学习。
第五类：临时编辑器。比如你要整理 30 个需求优先级，可以让 AI 做一个拖拽看板。拖完以后，点一下按钮，把结果导出成 Markdown、JSON 或下一轮 Prompt。
这不是做产品。这是给某个具体任务，临时造一个刚好够用的工具。
| 未来的好文档，可能不是一份文档，而是一个刚好够用的小工具。 |
05 但别误会：Markdown 没死
这件事最容易被误读成：以后都别用 Markdown 了。
其实不是。
Markdown 仍然适合记录原始想法、保存简洁文本、进入版本控制、给 AI 当上下文。它轻、稳定、好 diff。
HTML 的缺点也很明显：生成更慢，体积更大，版本差异更难看。
所以更合理的做法是：Markdown 做底稿，HTML 做展示。Markdown 给机器读，HTML 给人看。
这才是更现实的组合。
| 不是 Markdown 过时了，而是我们需要一种更适合 AI 时代的展示层。 |
结尾：AI 不是把文档写长，而是把工作变成界面
这篇文章真正提醒我们的，不是“HTML 比 Markdown 强”。
而是：当 AI 成为主要生产者，内容就不该再只是文字。
以前我们写文档，是为了记录。现在 AI 生成文档，是为了协作、判断、决策和继续推进。
所以格式也要升级。
以后你再让 AI 写方案时，可以少说一句：“帮我写个 Markdown。”
多说一句：“帮我做成一个 HTML 页面，让我一眼能看懂。”
这句话，可能会改变你和 AI 协作的方式。
| 下一代 AI 工作流的入口，也许不是聊天框，而是一个 HTML 文件。 |
