Markdown，该退休了！Claude Code 核心工程师爆火长文：写个 HTML 吧

来源：市场资讯

（来源：AI信息Gap）

Markdown，该退休了。

说出这个暴论的是 Thariq Shihipar。Claude Code 核心工程师，MIT Media Lab 出身，YC 创业者。

先说结论。「写个 HTML 吧。」

Thariq，我们之前聊过好几次了。

他那个「Lessons from Building Claude Code」系列，我持续追踪了三篇文章。提示缓存如何让 Agent 又快又省、怎么从踩坑中迭代出 20 个工具、怎么构建管理几百个 Skills。

今天要说的这篇不在那个系列里，是他 5 月 8 日单独发的一篇。

标题「The Unreasonable Effectiveness of HTML」。

「HTML 好用得离谱。」

Thariq 说，他已经「几乎完全停用 Markdown」了。方案文档、代码审查、设计原型、团队周报，全都用 HTML 输出。

后来这篇文章被 Anthropic 收录进了 Claude 官方博客。一个工程师的个人感悟，变成了官方推荐。

Markdown 在 AI 时代「火」了三年。从 ChatGPT 到 Claude Code，所有 AI 工具的默认输出格式都是 Markdown。

但 Thariq 的感受是，超过 100 行的 Markdown 文件，他就读不下去了。

「我也不可能让团队里其他人读完。」

AI Agent 越来越强，输出越来越长。Markdown 的表达力几乎要到顶了。流程图画不出来，没有配色，交互更是别想。

他在文章里贴了一张截图。Claude Code 在 Markdown 里试图用 Unicode 字符来「假装有颜色」。

莫名有点搞笑。

但如果换成 HTML 呢？

表格、SVG 矢量图、CSS 样式、JavaScript 交互，全都可以装进一个 .html 文件里。浏览器一打开，排版、导航、标签页、配色齐活儿。

Thariq 把 20 个 HTML demo 放在了 GitHub Pages 上，全用 Claude Code 生成，每个对应一个真实工作场景。

漂亮是真的漂亮。美观性和可读性双双拉满了。

这些 HTML demo 的地址在这里。

https://thariqs.github.io/html-effectiveness

选择设计方向的时候，他先让 Claude 生成一个 HTML 网格。6 种完全不同的界面方案并排放在一个页面里，有配色，有布局，每个方案标注了优劣。清晰明了。

以前在 Markdown 里，这只能是一种奢望。「方案 A 倾向于简洁，方案 B 强调信息密度…」你要自己脑补画面。

提交 PR 的时候，他让 Claude 生成一个 HTML 格式的代码解读。Diff 用颜色区分，旁边有内联注释，按严重程度分色标注。他说比 GitHub 默认的 diff 界面还好用。

现在他每提交一个 PR，都附带一份 HTML 代码解读。

HTML 还有一个 Markdown 永远给不了的东西。「交互。」

比如调试一个按钮的动画效果。直接让 Claude 生成一个 HTML 文件，里面放几个滑块。拖拽一下，效果实时变化。找到满意的参数，点「复制」，粘贴到 Claude Code 继续写代码。

Claude 输出给你看，你调试完又回传给 Claude。

30 个工单需要重新排优先级？让 Claude 生成一个看板，每张工单是一张可拖拽的卡片。拖到「现在做」「下次做」「以后再说」「砍掉」四列里。排列完，点导出。

调整颜色、正则表达式、cron 表达式，都可以这么干。

Thariq 把这种操作称为「一次性编辑器」。专门为手头这一件事量身定做的界面，用完就可以扔。以前要写代码，现在一句话搞定。

研究和学习也能用得上。

Thariq 写「提示缓存」那篇文章之前，让 Claude Code 读完了所有相关的 git 历史，然后生成了一份 HTML 格式的研究报告。里面有 SVG 流程图，有关键代码片段标注，还有一个「常见踩坑」的章节。

团队周报、事故复盘、技术分享，都可以这么生成。让 Claude 搜索你的工作空间、读取你的代码库、查看你的 git 记录，然后输出一份 HTML 报告。

他的 demo 里甚至有一个用箭头键翻页的 PPT。整个演示文稿就是一个 HTML 文件。不用导出。

那么，怎么用？

「你不需要做任何准备。直接对 Claude 说生成一个 HTML 文件就够了。」（其他 AI 同样适用。）

不需要写 Skills，不需要配置模板。描述你想要的内容，让 Claude 输出为 HTML 格式，浏览器打开就能看。

Thariq 补充道，「我有点担心大家会把这变成一个 /html 技能。完全没必要。先从零开始提示，感受一下不同场景下怎么用。」

这个技巧也不只适用于写代码。

Claude Code 处理非技术工作的基本套路就是「把文件丢进文件夹，让 Claude 写脚本处理，输出 HTML」。做计划、写报告、填表格，都能用。

Django 框架联合创始人 Simon Willison 说，这篇文章让他反思了自己从 GPT-4 时代养成的习惯。当年上下文窗口只有 8192 个 token，Markdown 省 token 是刚需。现在百万上下文，这个约束已经不在了。

有网友评论，「我们绕了一圈，回到了 Tim Berners-Lee 发明超文本时的初衷。」

也有不同意见。HTML 要比 Markdown 多消耗 2-4 倍 token，生成也慢 2-4 倍。git diff 又长又乱，协作时追踪改动很难受。也有人问，Anthropic 内部人推广更费 token 的输出格式，是不是有别有用心？

Thariq 回应道，「Opus 4.7 百万上下文，多消耗的 token 感知不到。」版本管理是 HTML 最大的短板，他也承认。

其实，HTML 和 Markdown 不是二选一，非黑即白。

短文本输出、草稿、Agent 之间传递信息，Markdown 还是首选。

但你要生成一份给别人看的方案、一份可视化的代码审查、一份带交互的原型、一份团队周报，HTML 强太多了。

下次再用 AI，试试「生成一个 HTML 文件。」

我是木易，Top2 + 美国 Top10 CS 硕，现在是 AI 产品经理。