别再让 AI 只写 Markdown 了

AI范儿 · 行业观察⏱ 7 分钟

AI AGENT OUTPUT 别再让 AI 只写 Markdown 了 给人看的内容，不该只是一坨文档。 它应该更像一个可以阅读的页面。

▲ 图：这篇文章本身，也应该像一个 HTML 页面

关注我的读者朋友可能会发现，我最近整个公众号的风格，其实有一个很大的改变。

变得更专业，也更美观了。

有很多人问我到底是怎么做的。

这个事情说起来还有点尴尬。

有一次开会，一个读者朋友特别认真地跟我说：

"你们的公众号排版特别丑。"

我当时还稍微有点不以为然。

但回头一看，好像确实是这样。

以前我更倾向于 Markdown 那种方式，简单、克制、没有任何花哨的东西。我还自认为，不要让形式大于内容。

但现在你看到的，是一种更丰富的表现方式，我相信整个的阅读体验会好很多。

这样的调整，其实导致我整个公众号的写作流程都变了，当然最核心的，这背后其实都是通过 HTML 实现的。

一次公众号改版 从 Markdown 草稿感，转向 HTML 页面感 旧版 像草稿，读起来费劲 HTML 新版 像页面，读起来顺

▲ 图：排版从草稿感，变成页面感

比较巧的是，今天正好刷到了 Claude 工程师 Thariq 的一篇长文，标题也很直接：

"The Unreasonable Effectiveness of HTML."

翻译成通俗的话就是：

这篇文章的核心判断AI 时代，Markdown 可能更适合机器和 Agent 读。但给人看的内容，HTML 可能更合适。

甚至有人说 Markdown 已经死了，现在是 HTML 重新回归的时代。

这话有点极端，但如果限定在“给人看的最终输出”这个场景里，我觉得还是有些道理的。

这次我想聊的不是排版技巧，而是 AI 给人类的输出形态正在发生变化。

从 Markdown，到 HTML，再到真正能被人读完的内容界面。

01以前怎么写

以前创作公众号文章，我很多时候就是在微信公众号编辑器里面直接写。

写完之后，再用公众号自带的一些模板，或者一键排版功能，生成那种固定风格。

但这样得到的排版，坦率说，比较简单。

甚至有点土。

我基本上都会往 Markdown 这个方向去贴合。

标题、列表、加粗、引用。

干净是干净。

但时间久了，我发现这个方式其实不太好。

因为很多时候文章会比较长，如果只是纯 Markdown 的方式，阅读起来真的会觉得很累。

Thariq 在原文里也提到，他很少能真正读完超过 100 行的 Markdown 文档。

同样一篇内容，交付感完全不同 Markdown HTML Artifact 阅读体验 长了就累 更容易扫读 结构表达 靠标题和列表 能直接视觉化 复杂信息 容易糊成文字墙 图表先行 风格统一 后期再加工 一开始就定好 公众号场景 只是草稿 接近成品

▲ 图：Markdown 和 HTML Artifact 的差别

所以我现在越来越觉得，Markdown 更像是草稿。

而公众号文章不是草稿。

它是一个需要被阅读、被滑动、被截图、被转发的内容产品。

这时候，只让 AI 写 Markdown，就像让设计师只交 Word 文档。

不是不能用，就是差点意思。

因为我日常写公众号比较多，所以我就以公众号来举例子。

但其实我觉得在日常生活当中，我们很多同学还在大量把 Markdown 当作终极交付的形态给到别人。

我觉得你不妨试一试 HTML 这种新的方式，可能会惊艳到你的同事们。

02为什么是 HTML

原文列举了很多原因，比如信息密度、方便携带、容易分享、能做交互等等。

这些都对。

但如果只说我自己的感受，我觉得最重要的是两点：

一个是信息密度。

另一个是美观度。

还有一个更微妙的东西，我不太确定怎么精准形容。

可能是一种降低信息负载的感觉。

人其实更愿意读图文并茂的内容，而不是面对简单枯燥、黑压压一片的纯文字。

以前我们觉得，把标题加粗，把重点标红，就算是排版了。

现在再看，这个方式已经有点不够用了。

但如果插入太多图片，又会打断阅读节奏。所以在 HTML 里加入 SVG，就显得特别合适。

HTML 为什么更适合人读？ 左边是文字墙，右边更像一本能快速翻读的杂志页 纯文字 / Markdown HTML 页面感 SVG 重点 案例 HTML 的优势不是装饰更多，而是让信息有层次、有入口、有节奏。

▲ 图：HTML 降低信息负载的三种方式

SVG 本质上就是一段代码。

它不像普通图片那样需要额外上传、压缩、管理，也不像 AI 生图那样风格容易飘。

流程图、对比表、概念图、结构图，它都很擅长。

当然，HTML 不只是有这些图。还可以有丰富的色彩、交互式的菜单、按钮等等。（尽管不是所有的都可以在公众号文章里面用）

对公众号这种阅读环境来说，真香。

03哪些适合 HTML

Thariq 还专门做了一个案例库，把 Agent 生成的 HTML 文件整理成了 20 个例子。

这个案例库很值得看：

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

我挑几个最有代表性的场景，你就能感受到 HTML 到底强在哪里。

HTML Artifact 适合做什么？ 更像一个案例陈列柜，而不是一张死板表格 探索规划 多方案并排比较 代码理解 Diff、模块图、注释 设计系统 颜色、组件、状态 研究学习 可导航的解释页 图示报告 流程、时间线、图表 自定义编辑器 调 Prompt、改配置 凡是需要比较、理解、导航、调整的东西，都适合 HTML。

▲ 图：Thariq 案例库里的典型 HTML 场景

比如探索规划。

你可以让 AI 一次性生成 3 个方案，横向摆在一个页面里，每个方案的优缺点直接标出来。

比如代码审查。

Diff、模块关系、风险点、Reviewer 应该重点看哪里，都可以做成一张可扫读的页面。

比如研究报告。

原来你可能拿到一篇长 Markdown，现在可以拿到一个带 TL;DR、图示、术语解释、FAQ 的学习页面。

这才是 HTML 真正有意思的地方。它不是把文字换个格式，而是把阅读体验重新组织了一遍。

04我的具体流程

说回我自己的公众号。

我现在的流程大概是这样。

我的公众号生产线 先写出人的情绪，再用 Skill 把它变成 HTML 页面 草稿 自己先写 Notion / 编辑器 Skill 直接排版成 HTML 统一标题、金句、CTA SVG 微调图示 长段落、概念、对比 发布 粘进公众号 不是先排版，再用 Skill

▲ 图：我的公众号从草稿到发布的 HTML 工作流

1先自己写草稿。

我基本上会自己先把文章草稿写好。工具通常是 Notion，或者直接在微信公众号编辑器里写，因为自动保存很方便。

这个阶段真的只是初稿。

之后我会反复打磨，包括用词、结构和情绪。

在创作内容时，我现在很少用 AI 了直接来写了。因为我觉得 AI 很容易抹掉文章里原有的情绪，这一点我不太喜欢。

但用 AI 来一起构思、一起整理、搜索素材还是需要的。

2直接用 Skill 排版输出。

写好草稿后，我会使用 Claude 或 Codex 里的 Skill 帮我进行排版。

这一步的核心，是输出 HTML 代码。

我肯定不会手动去写这些代码。直接让 AI 帮我写。

3Skill 固定统一风格。

因为我对自己的文章风格有统一要求，所以我单独定义了一个 Skill。

它会要求 AI 严格按照我的风格生成。

这样大家每次看到的标题样式、重点标注样式、CTA 样式，都会比较一致。

4反复调整 SVG。

排版并不是一步到位。我会来回调整，尤其是图示部分。

如果某个段落太长，或者里面有一些晦涩概念、数据对比、流程变化，我通常会要求 AI 生成一张 SVG。

重点我不是让 AI 替我写观点，而是让 AI 帮我把观点整理成更适合阅读的形态。

为什么我更喜欢 SVG，而不是 AI 生图工具？

原因也很简单。

第一，极简方便。SVG 本质上就是一段 HTML 代码，不需要像传统图片那样额外上传或管理。

第二，风格统一。SVG 的视觉风格天然能和 HTML 排版融在一起。

第三，场景契合。SVG 特别适合示意图、流程图、对比表格，这些刚好是公众号里最常用的解释方式。

总体来看，公众号里没必要用太多花哨图片。SVG 的表现力已经足够好，而且确实太好用了。

05重新回到 HTML

简单回顾一下。

我们曾经很长一段时间都觉得，Markdown 就是文档最好的交付形态。

它简单、稳定、可迁移，AI 也特别擅长处理。

如果是 AI 和 AI 之间，或者 Agent 和 Agent 之间交流，Markdown 确实可能依然是最好的选择。

因为机器不在乎好不好看。

机器只在乎结构清不清楚。

但如果输出是给人看的，那就完全不一样了。

人会累。

人会走神。

人会被一整屏黑压压的文字劝退。

所以在今天这个阶段，我反而觉得 HTML 正在重新回来。

不是因为 HTML 多高级。

而是因为它更接近人类真正阅读和理解信息的方式。

当然，HTML 也不是没有代价。

第一，生成速度会慢。

有时候我就坐在屏幕前，看着 Codex 在那里一行一行滚代码，啪啪啪啪地生成。

第二，Token 消耗会更多。

HTML 比 Markdown 啰嗦很多，尤其是带 SVG 的时候，代码量一下就上来了。原文作者觉得这个消耗还好，但我自己的感受是，它确实会耗 Token。

第三，分享成本也有点微妙。

你真要把一个 HTML 文件直接甩给别人，对方可能还会愣一下：这是什么东西？

HTML 也有代价 所以它不是万能格式，而是更适合给人看的成品格式 ⏳ 生成更慢 要等代码滚完 Token 更多 SVG 尤其吃上下文 分享更怪 需要一个承载页面

▲ 图：HTML 更像成品，但成品也更贵

同一份信息，给谁看？ 机器要结构，人类要理解路径，中间靠 Agent 转译 Markdown 结构清楚 机器就能处理 ⚙️ Agent 读取结构 转成页面 HTML 层次清楚 人更愿意读 不是谁替代谁，而是不同对象需要不同的交付形态。

▲ 图：Markdown 更适合机器，HTML 更照顾人类

给机器看的内容，Markdown 可能够了。给人看的内容，HTML 明显更友好。再往后，可能还会是视频、图片、交互页面，甚至更多新的形态。

所以我现在对 AI 写作的期待，也变了。

我不只是问它写了什么。

我会问：

这个东西能不能直接发布？

能不能让我少解释半天？

能不能让读者一眼看懂？

如果答案是否定的，那它写得再长也没用。

别再让 AI 只写 Markdown 了。

让它画图。

让它排版。

让它做 HTML。

不然 AI 辛辛苦苦写了五千字，最后只是在你的收藏夹里吃灰。

这谁受得了。

参考链接 https://x.com/trq212/article/2052809885763747935 https://thariqs.github.io/html-effectiveness/

你现在让 AI 交付最多的，是 Markdown，还是 HTML？

觉得有用 → 点个❤️在看转给朋友