Datawhale干货
作者：Thariq，Claude Code团队
前天，Claude Code 团队的 Thariq 写了一篇文章，标题叫《Using Claude Code: The Unreasonable Effectiveness of HTML》。现在，这篇文章在 X 上已经爆了，被 780 万人围观，超 2 万人收藏！
它爆火的原因，有一个很直接的反常识：
很多人用 AI，默认会让它写 Markdown。写计划，用 Markdown；写总结，用 Markdown；写 PR 说明，还是 Markdown。
这很合理。Markdown 简单、稳定、好改，放在代码仓库里也舒服。过去很长一段时间，Markdown 几乎就是 AI 和人之间最自然的交付格式。
但 Thariq 说，他现在越来越倾向于让 Claude Code 输出 HTML，而不是 Markdown。
更有意思的是，他也越来越多地看到 Claude Code 团队里的其他人这样做。
这就让人好奇了：
Markdown 明明简单、稳定、好改，也几乎是 AI 生成文档的默认格式。为什么最前沿的一批 Claude Code 团队成员，反而开始转向 HTML？
以下是这篇文章的核心内容整理，值得一读。
Claude Code 团队的人，开始少用 Markdown 了
Markdown 并没有坏掉。它依然简单、便携、容易编辑，也足够适合 README、说明文档、代码片段和轻量记录。
Thariq 也承认，Markdown 已经成了 Agent 和人沟通的主流格式。Claude 甚至很擅长在 Markdown 里用 ASCII 字符画图。
但 Claude Code 的使用场景变了。
过去，我们让 AI 写 Markdown，是因为它好改。人可以打开文件，手动调整几行，改个标题，删掉一段说明。
可 Thariq 发现，自己现在越来越少亲手编辑这些文件了。很多 Markdown 并不是拿来手工修改的，而是作为规格说明、参考材料、头脑风暴结果，或者下一步执行计划。
真要改的时候，他也往往不是自己打开文件一点点改，而是继续对 Claude 说：这里改一下，那里重写一下。
这就让 Markdown 的一个核心优势变弱了。过去的问题是：这个格式人好不好改。现在的问题变成了：这个格式人还愿不愿意读，能不能快速理解，能不能基于它继续做判断。
AI 时代真正的问题是：AI 写得太多，人不想读了
这件事真正击中的，不是“HTML 和 Markdown 谁更好”这种格式争论，而是一个更普遍的问题：AI 现在太能写了。
以前我们担心 AI 写不出来。现在越来越多时候，它确实写出来了，而且写得很完整。
一份实现计划，可以写几百行。一个 PR 解释，可以把背景、改动、风险、代码片段都讲一遍。一个技术报告，也可以把上下文、方案、数据、结论全都整理好。
问题是，人真的会读吗？
很多人用 AI 的时候，应该都有类似体验：它生成了一份看起来很完整的 Markdown，你打开扫一眼，觉得大概没问题，然后就让它继续。
不是因为内容一定不好，而是因为它太长、太平、太像一堵文字墙。
Markdown 的表达方式是线性的。标题下面是段落，段落下面是列表，列表下面是代码块。短的时候很清楚，一长就很考验人的耐心。
所以核心问题不是 AI 能不能生成文档，而是 AI 生成了这么多东西之后，人还愿不愿意读、看不看得懂、会不会参与判断。
HTML 和 Markdown 不一样，它能把 AI 输出变好读
一听到 HTML，很多人第一反应可能是：这不是网页吗？
但 Thariq 说的 HTML，不是让你去写网页，也不是让所有文档都变成网站。它更像是让 Claude Code 把复杂内容整理成一个更容易进入的页面。
同样是一份实现计划，如果写成 Markdown，它大概率是一段接一段的标题、列表、代码块和说明。你要从头往下读，才能慢慢拼出整体结构。
但如果写成 HTML，Claude 可以把不同方案放进 tab，把关键流程画成图，把代码片段放在旁边，把结论放在前面，把细节折叠起来。
这时你不是在“读完一份文档”，而是在浏览一个已经被组织好的工作台。
html像工作台的示例
这也是 HTML 相比 Markdown 的核心差异：它不只是承载文字，还能承载布局、图示、交互和视觉层级。
Thariq 提到，如果没有 HTML，Claude 有时会在 Markdown 里很努力地“假装可视化”：用 ASCII 字符画图，甚至用 Unicode 字符模拟颜色。
这很有趣，也说明 Markdown 本身不太适合承担复杂视觉表达。与其让 Claude 在 Markdown 里将就，不如直接让它用 HTML 把事情画出来。
HTML 不一定让内容更正确，但它会让内容更容易被人看见、理解和检查。
HTML 不只能看，还可以用来操作
不过，Thariq 这篇文章最有意思的地方，不只是说 HTML 更好读。
真正让人眼前一亮的是：HTML 可以变成一个临时小工具。
也就是说，Claude Code 不只是生成一个页面给你看。它还可以生成一个界面，让你在里面操作、调整、选择，然后把结果再回传给 Claude Code。
比如你要重新排 30 个 Linear tickets 的优先级。如果只在聊天框里做这件事，会很别扭。你要一条条说：这个放前面，那个往后挪，这几个先不做。
更自然的方式是，让 Claude Code 直接生成一个 HTML 看板。页面里有 Now、Next、Later、Cut 四列，每个 ticket 是一张可以拖动的卡片。Claude 先排一版，你再拖拽调整，最后一键导出 Markdown。
可以交互的HTML 看板
再比如调 system prompt。Claude 可以生成一个 HTML 页面，左边是可编辑的 prompt，右边放样例输入和实时预览，底部再放 token 计数和复制按钮。
这个变化很重要。HTML 把 Claude 的输出从“等你阅读的文档”，变成了“可以操作的界面”。
人在做判断时，经常不是线性阅读，而是在比较、移动、筛选、调整、反复看效果。HTML 把这部分动作接住了。
写在最后：Markdown 适合轻量文本，HTML 更适合复杂计划
当然，Thariq 并没有把 HTML 说成完美方案。
HTML 通常比 Markdown 更耗 token，也更慢。他提到，生成 HTML 可能比 Markdown 慢 2 到 4 倍。版本控制也是问题，Markdown 的 diff 很清楚，HTML diff 往往更吵。
所以这篇文章不是在说 Markdown 已经过时，也不是说所有 AI 输出都应该变成 HTML。
更准确地说，Markdown 适合轻量文本、README、简单说明、长期维护的文档。HTML 更适合复杂计划、代码解释、可视化报告、方案比较、交互调试和一次性决策界面。
这不是格式之争，而是场景选择。
而在文章最后，Thariq 最后讲到一个很关键的感受：他喜欢用 HTML，不只是因为它表达力更强，而是因为它让自己更 stay in the loop。
翻成更直白的中文，就是：人没有被 AI 的工作过程甩出去。
Claude Code 生成一份几百行的 Markdown plan，你扫一眼，觉得差不多，就让它继续。表面上看，是 AI 更自动化了；实际上，人可能也更容易失去判断感。
HTML 带来的变化，是把人重新拉回来。它让计划更容易读，让方案更容易比较，让代码变化更容易审查，让参数更容易调整，让结果更容易回传给 Claude。
所以 HTML 的价值，不是让 Claude 更独立，而是让人更容易介入。
这可能就是 Thariq 说 HTML “unreasonably effective”的原因：它看起来只是换了个格式，但真正改变的是人和 Claude Code 协作的感觉。
原文地址：https://x.com/trq212/status/2052809885763747935
一起“点赞”三连↓
