《用 Claude Code 写 HTML，比 Markdown 更不讲理地高效》

导语

Anthropic 的 Claude Code 首席工程师 Thariq Shihipar 写了一篇在 X 上获得万次转发的技术文章，核心论点只有一句：停止用 Markdown，让 AI 直接生成 HTML。 当代码工具的默认输出格式仍然是为“开发者在编辑器里阅读”而设计的 Markdown 时，AI 生成内容的实际读者早已变成了在手机上扫一眼的高管、在 Slack 里略读的队友、点链接的客户。格式升级的潜台词是：“写起来简单”已经不是约束条件，因为写的人不再是你。

1. 核心论点：Markdown 是为人类书写设计的，但现在书写者是 AI

Markdown 的设计目标是"人类写起来简单"——但当写作者变成 Claude 时，这个约束条件不再存在。 Claude 生成 HTML 跟生成 Markdown 一样容易，但 HTML 能承载的信息密度、视觉层次和交互能力远超 Markdown。Thariq 已经把自己的日常工作流中几乎所有 Markdown 文件替换成 HTML：报告、研究文件、每日简报、演示文稿、状态看板。

2. 用例地图：HTML 能做而 Markdown 做不到的事

文章列举了多个具体场景：

报告与研究：让 Claude Code 扫描 Slack 对话、代码库、git 历史记录和网页，将多源信息综合成可读性极高的 HTML 报告，可以是长文档、交互式解释器或演示文稿，还能用 SVG 生成图表。Thariq 写 prompt caching 的技术文章时，让 Claude 先读完 git 历史，再输出 HTML 格式的深度研究文件。

自定义编辑界面：让 AI 生成一次性的专用编辑器——比如一个带筛选、排序、对比功能的状态看板，用完即丢，不需要专门开发工具。HTML 让 Claude 的输出从"纯文本"升级为"可交互的微型应用"。

3. 代价与争议：HTML 不是没有短板

文章也坦承了代价：HTML 生成时间是 Markdown 的 2—4 倍，而且 diff 几乎无法审阅。 社区讨论中也有尖锐反驳：有人指出，Thariq 的前提是"我已经不看 100 行的 Markdown 文件了"，这与其说是 Markdown 的问题，不如说是 AI 输出臌肿的问题——HTML 只是用更漂亮的排版把冗余藏起来了。

实用规则：当输出需要反复阅读、团队审阅、状态追踪、对比筛选或后续编辑时，用 HTML；对于一次性笔记或简短命令摘要，Markdown 仍然更快。

结论

这篇文章的真正影响力不在于"用 HTML 替换 Markdown"这个具体建议，而在于它命名了一个所有人感觉到但没人说出来的转变：AI 代理的输出格式应该为读者而非写者优化。当"写"的成本趋近于零时，制约输出质量的唯一瓶颈变成了"读"的体验。

思想框架

作者先抛出反直觉的标题命题（HTML > Markdown）制造认知冲击，然后用一个简洁的逻辑链条支撑它：写作者变了（人→AI）→ "写起来简单"不再是约束 → 应该为"读"而非"写"优化格式 → HTML 在信息密度、视觉层次、交互性上全面胜出；再用具体用例（报告、看板、编辑器）证明可行性；最后坦承代价（生成慢、diff 难审）保持诚实。文章能引爆，核心原因是它用一句话命名了一个所有人早已感知但无人说明的转变。