HTML vs Markdown：AI时代的格式战争，为什么没有赢家

你让AI写个方案，它吐出300行Markdown，你扫了两眼就关了。

换成HTML呢？你居然愿意从头读到尾。

为什么？

这不是玄学。这是信息密度和交互方式的问题。

Markdown是怎么赢的

Markdown赢在两个地方：简单和生态。

简单到不用学。 你会用星号加粗，会用井号标题，就会用Markdown。它给人的感觉是"草稿"，是"中间态"，不是成品。这种心理门槛太低了，低到任何人都能随手写。

生态太完善了。 GitHub、Notion、飞书、Obsidian，几乎所有工具都原生支持。你写好Markdown，往哪粘贴都能看。AI工具（ChatGPT、Claude、Cursor）默认输出Markdown，因为它是"文本的子集"，解析成本低。

AI时代的早期，这种优势被放大了。那时候我们还是"手动编辑AI输出的内容"的阶段。你让AI写个报告，它给你Markdown，你改几行就发。这种模式，Markdown完美适配。

但现在变了。

Thariq的暴击

Thariq是谁？Anthropic的Claude Code团队成员。

2026年5月9日，他发了一篇《HTML不可思议的有效性》，直接暴击Markdown。

核心观点就一个：

Markdown最大的优势"人方便编辑"，在AI时代已经不成立了。

他的原话：

Markdown超过100行就不想读了

现在几乎不手动编辑AI生成的文件了，都是让AI改

Claude用ASCII画图就像"被关在小黑屋里的画家，手里只有铅笔，非要画油画"

Thariq做了20个自包含HTML文件示例（thariqs.github.io/html-effectiveness），涵盖：探索规划、代码审查、设计系统、原型、图表、演示文稿、研究、报告、自定义编辑器。

看完这些示例，你会发现一个事实：AI生成的文件，我们根本不再手动改了。我们让AI改。

既然不手动改，那"易于编辑"这个优势还有什么意义？

Markdown给人"草稿、中间态"的心理感觉，HTML给人"成品、交付物"的感觉

HTML允许空间化比较（并排看方案），Markdown强迫顺序阅读

HTML可以加滑块、按钮做双向交互，成为人和AI之间的"翻译器"

代码审查用HTML渲染diff+颜色标注，比Markdown列表高效

这些不是理论，是真实体验。

HTML的优势

HTML的信息密度高，因为它能容纳更多信息而不显得杂乱。

视觉化。 HTML能做表格、CSS样式、SVG矢量图。Thariq的示例里，有完整的设计系统、交互式图表、原型演示。这些在Markdown里要么做不到，要么需要外部工具渲染。

可交互。 HTML可以加滑块、按钮、折叠面板。人和AI之间的交互，不只是"你问我答"，而是"我调参数，你实时反馈"。这种交互，HTML天生支持。

易分享。 HTML做成单文件，上传S3就能分享。Markdown需要渲染才能看，要么你在本地预览，要么发到平台渲染。多一步，就少一层效率。

SVG画图。 这是AI生成内容的杀手级特性。AI可以直接在HTML里嵌入SVG，画流程图、架构图、数据可视化。Markdown呢？要么用ASCII手绘（难看且难读），要么用Mermaid（需要平台支持），要么外部链接图片（不连贯）。

为什么现在是个混乱状态

如果HTML这么好，为什么大家还是用Markdown？

因为生态位。

平台原生支持。 微信公众号、GitHub、Notion、飞书，这些平台原生支持Markdown。你用Markdown写完，直接粘贴就能用。HTML呢？在公众号平台会被过滤标签、SVG被过滤、CSS被剥离、JS直接删除。你费劲做的好东西，一传上去就废了。

学习成本。 Markdown的学习成本为零，HTML需要懂CSS/JS。不是所有开发者都熟悉前端，大多数人不想为了一个文档去学CSS。

短文档场景。 对于<100行的短文档，Markdown完全够用。这时候你用HTML，是杀鸡用牛刀。

转换灵活性。 Markdown可以渲染成HTML、PDF、电子书、Word。HTML只能当HTML用。当你需要多种输出格式时，Markdown是唯一选择。

所以现状是：HTML在"AI生成内容的展示"上有优势，但Markdown在"生态和普适性"上有护城河。

没有赢家，只有场景分化。

我的实际体感

我用AI写文章时，HTML在微信公众号排版经常出问题。

SVG被过滤、CSS被剥离、JS直接删除。我费劲做的交互效果，到公众号里变成一堆乱码。

Markdown虽然丑，但至少不会出错。

这也是为什么我给这篇文章写了纯Markdown，没有用HTML。

但我承认，有些场景下，HTML的体验是Markdown完全无法替代的。比如代码审查：HTML渲染diff+颜色标注，比Markdown列表高效太多。比如交互原型：HTML可以直接点击、拖动，Markdown只能写文字描述。

未来怎么走

不是二选一，而是根据场景选。

交互原型用HTML。 你想让用户点击、拖动、反馈，用HTML。单文件，易分享，效果好。

文档分享用Markdown。 你想发GitHub、公众号、飞书，用Markdown。平台原生支持，不会出错。

演示报告用HTML。 你想做PPT、dashboard、数据分析报告，用HTML。SVG画图、CSS布局，信息密度高。

日常笔记用Markdown。 你自己写笔记，用Markdown。简单、快速、可搜索。

关键是：AI应该能自动判断用哪种格式。

你让AI"写个代码审查报告"，它应该输出HTML，因为有diff、有颜色标注、有交互折叠。你让AI"写个技术文档"，它应该输出Markdown，因为你要发到GitHub。

这不是格式选择问题，是AI理解用户意图的能力问题。

结尾

HTML和Markdown不是替代关系，是分工关系。

HTML vs Markdown不是战争，是AI输出什么格式最合适这个问题的答案在分化。

HTML在"AI生成内容的展示和交互"上有不可替代的优势，Markdown在"生态和普适性"上有坚实的护城河。

生产端要的是轻、是快、是可diff、是token-efficient。那就是md。 消费端要的是丰富、是可视化、是可交互、是好分享。那就是html。

未来不会是某一方统治一切，而是根据场景智能选择。

AI应该理解：你要交互原型，我给你HTML；你要文档分享，我给你Markdown。

这才是"智能"该有的样子。

参考资料：

• Thariq《HTML不可思议的有效性》：https://thariqs.github.io/html-effectiveness/
• 用了 Claude Code 这么久，我才发现 Markdown 格式是个坑
• Markdown还是HTML？这是个蠢问题！
• md 是源代码，html / docx 是产物 https://github.com/alchaincyf/huashu-md-html
• 960万人围观！Claude Code工程师谈HTML“复兴”：Agent时代，Markdown不够用了 https://zhuanlan.zhihu.com/p/2037255576577646831
• Using Claude Code: The Unreasonable Effectiveness of HTML https://x.com/trq212/status/2052809885763747935