Markdown 与 HTML 之争:Agent 时代,普通用户该选谁输出结果?
过去两年,大模型交付内容大概率用 Markdown 格式。原因很简单,Markdown 干净、无多余格式,复制到文档、知识库、GitHub 甚至微信公众号后台,都不会有大问题。某种意义上,Markdown 是公认的 AI 时代最好的标记语言。
不过,随着 Agent 时代到来,Markdown 风评急转直下,老掉牙的 HTML 反而被开发者们疯狂推荐。为何会有这样的变化?Anthropic 的 Claude Artifacts、OpenAI 的 Codex、近期爆火的 Openclaw、Hemers 等 Agent 工具,最终交付的往往不是纯文本,可能是 SVG 动画、程序甚至完整视频。在这种情况下,通常仅以纯文本方式呈现的 Markdown 就不太够用了。Anthropic Claude Code 团队成员 Thariq Shihipar 在文章里也提到,相比 Markdown,Claude 更应用 HTML 输出结果。
但 HTML 真就比 Markdown 好吗?其实未必。
老家伙逆袭取代 Markdown,靠的是「全能」
Markdown 不算新东西。2004 年,John Gruber 提出 Markdown,其定位是面向网络写作者的 text - to - HTML conversion tool,即让写作者先用接近普通文字的方式写完内容,再通过工具转换成 HTML。Markdown 从一开始就不是为替代 HTML,而是降低写 HTML 的门槛,像一层更容易上手的中间语,帮作者先忽略写 HTML 过程中必须关注的规范,优先专注把内容顺畅写出,再交给工具处理。
所以,Markdown 后来在博客、论坛、知识库、开发文档和 GitHub 上流行,靠的是简单的写作规范,工具里只有标题、列表、引用、加粗、链接等最常见的排版需求,作者无需关注其他东西。
而 HTML 历史更悠久。1989 年,Tim Berners - Lee 提出万维网构想,到 1990 年底已定义出 Web 的几个基础概念,包括 HTML、HTTP 和 URL,并写出第一个浏览器、编辑器和服务器。也就是说,HTML 几乎随互联网一起出现。
相比 Markdown,HTML 麻烦之处在于,作者写作时要关注标题、段落、链接、图片、表格、表单、导航、按钮等一大堆东西,很可能打断思路。当然,HTML 能呈现的东西更丰富,毕竟其核心是呈现「小网页」,能显示、交互、提供动效的元素更多。
同一套提示词下,让 AI 做一份个人简历,提供虚构的姓名、信息、工作经历和教育背景,同时输出 Markdown 和 HTML 两种形式。Markdown 版本很简单,信息完整,但 HR 收到可能认为不够专业;HTML 版丰富很多,真像一份简历。
再看最常见的手机导购表在 Markdown 和 HTML 两种形式下的区别。制作这类图表时,Markdown 输出标准,无多余话语,参数信息直给且清晰。但论细节丰富程度,HTML 更胜一筹,比如色彩选择、推荐指数的直观呈现方式等。
但 HTML 就彻底赢了吗?未必。同一套提示词下,让 AI 做创业者的书单推荐,在无太多干预的情况下,Markdown 输出结果更清晰,书名、简介、推荐指数一眼读懂;HTML 动效好、视觉效果拉满,但不能让人清晰了解该从哪本书开始阅读。
最后看技术教程场景,这次 Markdown 赢面更大。技术教程本身是偏线性阅读过程,需从上到下浏览,Markdown 逻辑与之吻合,代码块直接嵌在步骤里,注意事项缩进,看着清晰。HTML 即便开放性高,在此场景下也得做简单化处理,但还是 Markdown 更简洁。
从这些实际案例看,Markdown 没被 HTML 完全碾压,在资料收集、文本整理部分,Markdown 更能呈现清晰、简单的结果。但为何大佬更推荐 HTML?因为 HTML 能承载更多元化内容,如写简历和做导购,HTML 带来的丰富视觉效果是 Markdown 无法比拟的。
抛弃 Markdown?话还说太早
从前面体验看,很多人会问:HTML 这么好,是不是所有人都该抛弃 Markdown,全面拥抱 HTML?并非如此。
多数人印象里,AI 就是聊天窗口,输出什么格式无所谓,自己看得懂就行,Markdown 在这个场景完全够用,甚至因简洁更合适。但如果 AI 要帮做事,Markdown 可能不够出色。
其实,Markdown 从一开始就是为「写作的人」设计。用它写东西,写完交给平台,平台把那些 ## 和 ** 变成好看的标题和粗体,用户才能看到想要的效果,更直接地说,Markdown 天生就需要一个「帮它翻译的人」。HTML 打开就是结果,浏览器就是其运行环境,全世界每台电脑、每部手机都有浏览器,HTML 不需要人帮翻译,自己就是成品。
想象一下,让 AI 做一份 PPT。如果输出的是 Markdown,拿到的不是 PPT,而是描述 PPT 长什么样的说明书,还得自己找能读懂说明书的软件,如 WPS 或 Office 套件,才能看到真正的幻灯片。但如果输出的是 HTML,点开就是完整、可直接用的成品。
这就是为何几乎所有大佬都更推荐在 Agent 上要求输出结果为 HTML,这样能得到真正的成果,而非半成品。
另外,现在是 Agent 时代,不仅要考虑人和 AI 工具之间的协作,还要考虑 AI 与 AI 之间的协作,一个 Agent 生成内容,另一个 Agent 接收并展示,或者直接推送给用户,在这条链路上,HTML 可以无缝流转,打开即用。
不过,Markdown 目前用途远比想象多。最经典的例子,AI 训练时读进去大量 Markdown 文档,如 GitHub 上的项目说明、技术博客、各种开源文档,格式大多是 Markdown。所以 AI 对 Markdown 的结构天然熟悉,理解起来最顺畅。很多开发者也更愿意把自己的技巧分享成 Markdown 格式,方便其他开发者直接喂给 AI。
所以,不是 HTML 在 Agent 时代更适合多数普通人「想要得到完美成果」的需求,就代表 Markdown 该被取缔,它们各有适合的场景和使用方式。
选 Markdown 还是 HTML,这是一个问题
作为普通用户,要求 Agent 输出结果时,该选 Markdown 还是 HTML?其实很简单,先想一想,结果是自己看,还是要分享给别人看。
比如旅行攻略案例,让 AI 整理三天的京都行程,自己安排、自己用,Markdown 简洁直接,信息直罗列,看着更清晰。这时若让 AI 输出 HTML,会发现拿到的东西和 Markdown 版几乎没差别,因为 HTML 的设计能力在这里无用武之地,提示词还更难写,纯属多此一举。
如果要给别人看,尤其是场合比较正规,用 HTML 效果更好。比如工作周报,Markdown 版只能靠 Emoji 区分状态,发给领导显得随意;HTML 版绿黄灰三色一眼看清,进度条直接标出完成多少,面子功夫做到足。
另一个判断逻辑是,是否需要输出结果是「排版好看」的内容。如果不在乎排版,只想要信息本身,Markdown 就是所需;但如果设想中已想好整个排版、布局、配色、动效,那就只能用 HTML 了。
总的来说,HTML 虽是大佬力推的 Agent 输出结果格式,但也要根据自己所需的场景进行选择,Markdown、HTML 各有自己场景下的优势。