乐于分享
好东西不私藏

AI 写报告别只要纯文字了:真正值钱的是把文档变成决策界面

AI 写报告别只要纯文字了:真正值钱的是把文档变成决策界面
AI 大实话 · 工作方式

AI 写报告别只要纯文字了
真正值钱的是把文档变成决策界面

老K的AI大实话 · 前大厂技术人

这篇文章不教你写前端。

我也不想把它写成那种「HTML 要火了,大家快去学」的浅层热点文。

真正值得聊的不是 HTML,也不是 Markdown。

真正值得聊的是:AI 时代,很多交付物正在从「文档」变成「界面」。

你给老板交汇报,别人交一份 20 页 PPT,你交一个能点、能筛选、能直接复制结论的单页页面。

你投简历,别人写「熟练使用 AI 工具」,你给一个能打开的 AI 作品集页面,里面有项目背景、你的判断、AI 参与了哪部分、最终产出。

你做项目复盘,别人发一篇长文档,你给一个带时间线、风险卡片、责任项、后续动作的可交互报告。

你说老板、客户、面试官会先看谁?

这才是我觉得这件事值得写成长文的原因。

同一份材料,为什么有的人交上去像作业,有的人像产品

先讲一个很具体的场景。

周五下午,老板突然让你整理一份竞品分析,下周一开会用。你把资料丢给 AI,说:

帮我整理成一份汇报。

AI 很快给你一份 Markdown:竞品 A/B/C 各自的优势、劣势、价格,建议优先关注 B。你看了一眼,觉得挺好。接下来你开始做熟悉的体力活:复制到飞书,调格式;复制到 PPT,改字号;截图,配图;把表格拆成两页;再担心老板嫌字太多,又删一遍。

这套流程没有错。过去几年大家都是这么干的。

但想象另一个同事交的是这样一个东西。打开就是一句话结论:

如果预算有限,优先盯竞品 B;如果要防守高端客户,必须盯竞品 C。

下面有三个按钮:成本优先 / 风险优先 / 增长优先。老板点「成本优先」,页面自动把低价竞品排在前面;点「风险优先」,高风险项变成红色卡片;点「复制结论」,直接得到一段可以发到群里的 100 字摘要。

这不是花活。这叫降低决策成本

很多人做汇报,心里想的是「我把材料整理清楚了」。但老板真正要的通常不是材料,而是判断。材料越多,老板越累。判断越清楚,交付越值钱。

AI 时代真正拉开差距的,很可能不是「谁更会写」,而是「谁能把复杂材料变成别人更容易做判断的东西」。这就是我说的「文档变界面」。

Markdown 为什么曾经是 AI 的默认答案

别急着说 Markdown 不行。Markdown 过去几年确实非常适合 AI 输出。原因很简单:它轻、它干净、它好复制、它能被 Git 追踪、它不像 HTML 那样满屏标签、它对大模型来说也省 token。

更关键的是,过去我们使用 AI 的方式,默认有一个前提:

AI 负责给初稿,人负责继续改。AI 给你一段文字,你复制出来自己排版。AI 给你一份方案,你自己做成 PPT。

在这个前提下,「好编辑」比「好展示」重要。Markdown 正好解决「好编辑」这件事。所以过去我们形成了肌肉记忆:请输出 Markdown。

这句话没错。只是它背后的工作方式,开始变了。

真正变强的不是 HTML,而是 Agent

最近 Claude Code 团队工程师 Thariq Shihipar 提了一个很有冲击力的观点:Markdown 正在限制 Agent 的表达能力,HTML 反而更适合 Agent 时代的人机协作。

Simon Willison 在 2026 年 5 月 8 日转载并试了这个思路。他提到,HTML 可以让 AI 输出的不只是解释文字,还能放进 SVG 图、交互控件、页面导航和更丰富的信息结构。

Thariq 的示例集合里有 PR Review、代码理解、设计系统、原型、流程图、周报、事故复盘、自定义编辑器。这几个场景有一个共同点:

都不是单纯「读一段文字」就能解决的。代码 Review 需要 diff + 严重级别。事故复盘需要时间线 + 日志。设计系统需要颜色 + 字号 + 组件状态。这些东西全塞进 Markdown,就会变成一堵墙。能读,但累。

HTML 的价值不在于「它是网页语言」。它的价值在于:浏览器是今天最普及、最稳定、最便宜的运行环境。你不需要安装什么软件,不需要导出,不需要别人懂你的工具链。一个 HTML 文件,打开就是结果。

你让一个已经能处理复杂上下文的 Agent,最后只能用几个标题和列表表达,就像让一支乐队只能吹口哨。不是它不会演奏,是你给的乐器太少。

这不是「HTML 干掉 Markdown」,而是三层分工

我不认同那种简单粗暴的说法:Markdown 要死了。这种话适合做标题,不适合做判断。

我的判断是:Markdown 不会死,但它的位置会变。你可以把未来 AI 交付分成三层:

第一层 / 数据层
JSON · YAML · CSV · 数据库
负责准确、可复用、可计算——不负责好看
第二层 / 草稿层
Markdown 文档
提纲、正文、说明、技术文档——轻、清楚、好改
第三层 / 展示层
HTML 单页界面
按钮、筛选、卡片、图表——让读者更快做决定

注意,我说的是「脚手架」。不是花里胡哨的动效,不是廉价炫技,不是把一份 Word 换个壳。

真正好的 HTML 交付物,应该让读者更快做决定。如果只是更漂亮,但没让人更快理解,那就是新的 PPT 病。

普通人不需要学前端,但要学会指挥 AI 做交付物

这里要把一个误会说清楚。普通人不需要因为这件事去系统学 HTML、CSS、JavaScript。重点是,你要知道什么时候该让 AI 输出 Markdown,什么时候该让 AI 输出 HTML。这就像你不需要会修发动机,也可以知道高速路上不能开拖拉机。

Markdown 就够了
给自己记笔记
写草稿
写技术说明
做版本管理
给 AI 继续处理
试试 HTML
对方需要做判断
有多方案对比
有风险等级
有时间线
需要筛选展开
要一眼看懂

这不是技术问题。这是表达问题。更准确地说,是交付问题

哪些工作最先被这件事影响

1月度汇报

传统月报写得再认真,也很容易被扫一眼就关掉。

但如果你做成单页 HTML:顶部一句话总判断 → 本月完成事项用卡片展示 → 延期事项用红色风险卡展示 → 下月计划用时间线展示 → 需要老板决策的地方单独做成按钮区。

它不是更酷,它是更像一个给老板用的东西。

2竞品分析

竞品分析最怕变成资料堆积。大家都写功能、价格、定位、优缺点——但老板看完还是不知道该怎么选。

HTML 单页可以让这个东西变成可筛选的决策表:按价格排序、按风险筛选、点击展开证据、最后输出推荐方案。这时候你交的不是「我整理了资料」,而是「我把判断入口做好了」

3项目复盘

项目复盘里最有价值的东西通常不是长篇反思,而是因果关系:什么时间发生了什么?哪个判断错了?下次谁负责改?

HTML 可以把它拆成时间线、影响范围、原因树、行动清单。读者不需要从头读到尾,先看总览,再展开细节。很多复盘没人看,不是因为大家不关心,而是因为复盘写得像处罚通知。

4求职作品集

学生或应届生最该关注这个。简历上写「熟练使用 AI 工具」,现在已经很弱了,因为人人都会写。

更有说服力的是一个单页作品集:这个项目解决什么问题 → 你负责哪部分 → AI 帮你做了什么 → 哪些判断必须你自己做 → 最终结果 → 你踩过什么坑 → 如果重做会怎么改。

公司招人的时候,嘴上说看学历、看经历,本质上还是看一个问题:你来了以后,能不能交付东西?

一个能打开、能看懂、能展示你判断过程的页面,比一句自我评价更有用。

这件事也有坑,别把 HTML 当新玄学

我不想把这篇写成「HTML 万能论」。任何新格式都会带来新问题:HTML 比 Markdown 更长、生成更慢、版本 diff 更乱、审美更容易翻车、一旦让 AI 放飞,很容易变成动画过度、颜色刺眼、按钮乱飞的垃圾页面。

⚠️ 还有一个更隐蔽的问题:HTML 会让差内容看起来更像样。一份没判断的报告,套上漂亮卡片,还是没判断。一个不懂业务的人,用 AI 做出再漂亮的界面,也只是把空心内容包装得更精致。

所以我的建议很简单:

先让内容站住,再让界面帮它表达。顺序不能反。

你要先问:我的核心判断是什么?读者要做什么决定?哪些信息必须第一眼看到?哪些细节可以折叠?回答完这些,再让 AI 生成 HTML。否则你只是从「PPT 八股」换成「HTML 八股」。

你今天就可以做的练习

别等。找一个最近真实发生过的工作材料(周报、竞品分析、项目复盘、课程作业、实习总结、客户方案……),然后对 AI 说:

PROMPT 模板 · 直接复制使用
请把下面这份材料整理成一个单页 HTML 汇报页。  目标读者:我的老板/面试官/客户。 目标动作:让对方在 3 分钟内理解重点, 并能做出下一步判断。  要求: 1. 顶部先给一句话结论。 2. 用一个目录展示页面结构。 3. 把核心内容分成 4 个模块:    背景、关键发现、风险、下一步动作。 4. 用对比表展示不同方案的优缺点。 5. 用风险卡片标出高/中/低风险。 6. 每个模块默认只展示结论,    细节放进可折叠区域。 7. 最后给一个「复制给老板的 100 字摘要」。 8. 风格克制,不要赛博朋克,不要花哨动画。 9. 所有内容必须基于提供的材料,不要编造。  下面是原始材料: 【粘贴你的材料】

第一次做出来可能很丑。没关系。你要看的不是美不美,而是三个问题:

·我自己是不是更容易看懂了?
·对方是不是更容易做判断了?
·这个东西是不是比原来的文档更像一个交付物?

只要有一个答案是肯定的,你就已经摸到门了。

最后给你一个判断框架

以后你让 AI 输出内容前,先问四个问题:

① 这个东西是中间稿,还是最终交付?
中间稿用 Markdown 很好。最终交付要看场景,很多时候 HTML 会更合适。
② 对方是要阅读,还是要判断?
如果只是阅读,文档够了。如果要判断,界面更好。
③ 内容里有没有对比、筛选、风险、时间线、行动项?
如果有,它天然适合做成结构化页面。
④ 这个页面有没有帮读者少花脑子?
如果没有,那就别做。漂亮不重要,少花脑子才重要。

我的判断是:未来几年,Markdown 会继续活得很好,但它会越来越多地停在「底稿层」。真正值钱的,是你能不能指挥 AI,把底稿变成别人愿意看、看得懂、能行动的交付物。

这件事对普通人真正的意义,不是「HTML 要火了」。

而是:会交付的人,会比会写文档的人更值钱。

如果你想要我整理一份「单页 HTML 汇报 Prompt 模板」,评论区留言:

HTML

我是老K,前大厂工程师,现在做 AI 创业。这个号会持续帮你判断:AI 时代哪些能力会涨价,哪些工具该用,哪些机会值得追。

参考资料

Thariq Shihipar:Markdown 与 Agent 协作的讨论(x.com/trq212)

SimonWillison:The Unreasonable Effectiveness of HTML(simonwillison.net,2026.05.08)

HTML 示例集合:thariqs.github.io/html-effectiveness/