Markdown已死HTML当立？Claude Code团队这篇文章把我干碎了

这两天被一篇文章搞到失眠。

不是夸张的修辞，是真的躺在床上想了一个多小时。

事情是这样的。Anthropic Claude Code团队的工程师Thariq Shihipar发了篇东西，标题叫《The Unreasonable Effectiveness of HTML》。核心观点就一句话，别再让Claude输出Markdown了，让它直接输出HTML。

我看到这句话的时候，第一反应是"？？？"

Markdown不挺好的吗？我写了三年了。GPT-4时代用的就是Markdown，简洁、轻量、跨平台、Token效率高。你突然跟我说HTML？那不是又大又重吗？

但我把文章读完，又看了他整理的20个示例页面之后，说实话，我沉默了。

因为他说的对。

不是"也有道理"那种对。是"我之前的习惯其实一直在限制AI的表达能力"那种对。

先聊聊Markdown为什么成了AI输出的默认格式。

这事其实有历史原因的。GPT-4出来的时候，上下文窗口只有8192 Token。Markdown比HTML省Token，所以成了最优解。大家都养成了让AI输出Markdown的习惯。ChatGPT的界面也支持Markdown渲染，代码块、加粗、斜体这些够用了。

但问题是，我们把这个"够用"当成了"正确"。

Thariq的原话更狠。他说Markdown虽然简单易编辑，但面对越来越复杂的Agent输出时已经明显不够用了。他用了一个特别好的比喻——在Markdown里，你想展示一个复杂的对比表格，或者画一个架构图，或者用颜色标记不同严重等级的代码问题，你能怎么做？用Unicode拼出来的ASCII图？用emoji当颜色标签？

说真的，我以前就是这么干的。

在PR Review的summary里，我用表示严重问题，用⚠️表示警告，用✅表示通过。读者需要自己脑补颜色。这种体验，现在回想起来，简直就是石器时代的做法。

HTML一出来，局面完全变了。

同样一个PR Review，让Claude输出HTML，它可以做渲染代码diff、在每一行旁边加上彩色注解、用视觉层级告诉你哪里是核心风险、哪里可以一略而过、甚至画一张流程图解释数据流走向。

这不是多了一两个功能。这是从"文字告诉我"变成了"让我自己看到"。

这中间的差别，怎么说呢，就像你跟朋友描述一个人的长相，和直接给他看一张照片。

Thariq的文章把HTML的优势拆成了几个维度，我按自己的理解重新整理了一下。

第一个是信息密度。

Markdown的表达上限天花板很低。你再怎么玩，也就那几种格式，标题、列表、代码块、表格。HTML不一样，CSS样式、SVG插图、标签页、绝对定位、交互式画布——能呈现的东西几乎没有上限。一个几百行的Markdown文档需要读者花二十分钟逐字消化，HTML可以在一个页面里同时呈现结构总览、细节展示和多层链接，让不同需求的读者各取所需。

第二个是分享体验。

这个太真实了。Markdown文件发给非技术团队，对方要装编辑器或者用预览工具才能看。HTML可以直接上传到任何静态托管，发一个链接，任何浏览器直接打开。阅读门槛降到了零。我公司里经常要给产品经理看技术方案，以前要转PDF、截图、配文字说明，现在一个HTML链接甩过去，对方自己看、自己点、自己导航。

第三个，也是最让我兴奋的，是双向交互。

这一点完全超出了我之前对"文章"的理解框架。HTML不只是呈现信息的容器，它可以成为交互界面。你可以让Claude生成一个带滑块的工具让用户调整参数看实时效果，可以加按钮让用户导出JSON或Prompt，可以做成可拖拽的项目看板。

信息不再是单向流动了。你读一篇文章的过程中，可以操作它、修改它、用它产出新东西。这是我之前从来没想过的。

Simon Willison的体会跟我一模一样。他说自己从GPT-4时代就一直默认Markdown，但因为Thariq这篇文章，他开始重新思考这件事，并且当场做了个实验——把一个Linux安全漏洞的exploit代码扔给GPT-5.5，让它用HTML解释。结果出来的页面有折叠代码段、交互式解析、逻辑流程图，比纯文本解释好几条街。

看到这里，你可能跟我当时想的一样，HTML生成时间更长，Token消耗更高，版本控制的diff也不友好，这些代价值不值得？

Thariq在文章里没有回避这些代价。他自己列出来了，很诚实。

HTML生成Markdown大概多花2到4倍的时间，Token消耗肯定是高的。Git diff对比HTML文件的时候确实不太好看，因为HTML tag太多了。

但他的判断是，整体收益远超成本。

尤其是在现在1M+ Token上下文窗口的时代，效率差已经被抹平了。以前省Token是因为窗口小，现在窗口大了，与其节省一点点成本但产出低效，不如多花几十K Token换一个能真正改变理解效率的交付物。

我觉得这话非常在理。

另外一个容易被忽略的点是，HTML生成质量本身也依赖模型能力。Thariq特别提到Claude对HTML、CSS和JavaScript的理解很深，生成的代码干净、结构化好、跨浏览器兼容性强。这不是所有模型都能做到的。有些模型生成的HTML像是从1999年穿越过来的，各种标签和inline style堆在一起。

但Claude确实可以把HTML写出"当代感"。

聊完技术优势，我想回到一个更根本的问题上来。

Markdown到HTML的转换，表面上是输出格式的切换，背后其实反映了我们对AI角色的理解在升级。

GPT-4时代，AI是个问答机器。你提问，它回答，回答的内容用最简洁的格式呈现就够了。Markdown完美胜任。

但到了Claude Code时代，AI已经是一个协作者了。它帮你做代码审查、写架构方案、出对比报告、画系统图。这些东西靠纯文本是搞不定的，因为它们本质上不是"信息"问题，是"理解"问题。

一个好的代码审查界面，它不是在给你信息，它是在帮你建立理解。

你脑子里的理解路径是这样的，看到红色标记→意识到这是高风险→扫一眼左边的注解→发现这个修改会影响下游模块→点击展开流程图→看清整个数据链路→回到代码行确认具体逻辑。这一整套过程在HTML里是直觉性的，在Markdown里你得一个人硬读。

所以Thariq要推动的，不是一个格式选择问题。他在推动的是AI协同时代我们交付和消费信息的界面革命。

---

最后说点实操的事。

入门门槛极低。不用装任何skill，不用配任何东西。你只需要在提示词最后加一句make a HTML file或者create an HTML artifact，剩下的Claude会搞定。如果想做得更好，可以加具体需求，渲染代码diff、用颜色标记严重等级、做个可交互的时间线、加一个导出按钮。

Thariq给的模板是这样的，

Help me review this PR by creating an HTML artifact that describes it. I'm not very familiar with the streaming/backpressure logic so focus on that. Render the actual diff with inline margin annotations, color-code findings by severity and whatever else might be needed to convey the concept well.

逻辑很简单，说清楚你要什么，说清楚你想怎么交互，让Claude自己发挥。

Simon Willison试完之后的点评也很有意思。他说，我以前写过工具型HTML的用法，但那是让AI生成实用的交互小工具。现在Thariq让他意识到，日常的ad-hoc提问也可以用HTML提升体验，不只是工具页面，所有类型的解释和报告都可以。

我觉得这句话是整件事最好的总结。

我们从"把HTML当工具用"，进化到了"把HTML当语言用"。

Markdown没死，但它不再是唯一解了。