md-viewer-skill 真正补上的，不是 Markdown 预览，而是 AI 输出终于开始配得上显示界面

很多人现在已经习惯了 Claude Code、Cursor 这类工具在终端里刷刷刷往外吐东西。代码、报告、总结、分析、Mermaid 图、表格，生成速度是快了，可有个问题一直没怎么被认真对待：

AI 的输出越来越像成品了，但我们看的方式还停留在纯文本时代。

这就是 md-viewer-skill 真正戳中的地方。

表面看，它只是一个让 Claude Code 把 Markdown 丢进浏览器里实时渲染的小工具。可它背后碰到的，其实不是 Markdown 好不好看这么简单，而是 AI 工具链里一个越来越明显的断层：生成端已经升级了，显示端还没跟上。

你想想就知道了。Claude 现在动不动就能给你整出一份长报告、一段 Mermaid 图、一张复杂表格、一整套结构化分析。理论上这些东西已经不是草稿了，很多时候都快接近交付物了。可你真正看到它们的时候，还是在终端那个黑框框里，一行行硬看。标题就是一排井号，表格就是一堆竖杠，图表就是一团你根本不想肉眼解析的代码块。

说白了，不是 AI 生成得不够好，而是你看它的方式太遭罪。

这就很有意思了。因为过去大家对 AI 工具的关注点，一直放在“它会不会写”，很少有人认真想“写出来之后怎么舒服地看”。可一旦 AI 开始真的承担更多文档、分析、汇报、架构说明这类输出，展示这层就不再是小问题了。

md-viewer-skill 之所以让我觉得值钱，就是因为它切的正是这个低调但高频的痛点。

它没去造一个更大的系统，也没整什么复杂架构，反而用了一种挺克制的办法：本地起一个轻量服务，把 Claude 生成的 Markdown 渲染成浏览器里你真正看得懂、看得顺眼的样子，而且还支持自动刷新。你继续让 Claude 在终端里生成，它那边一份份往里写，你这边浏览器里就像看一个持续更新的文档面板。

这事儿看着小，实际上很实用。因为它直接把 AI 输出从“只能凑合看”的状态，往“真的能当结果物看”的状态推了一步。

尤其对几类场景特别有感觉。

第一种，是长报告。

Claude 现在非常擅长生成那种结构化很强的分析内容，问题也就在这。终端一旦刷了三屏，你往回翻都费劲，更别说找某一段、比较前后逻辑、顺着目录跳着看。放到浏览器里之后，层级、段落、表格、代码块、图都回到它们本来该有的形态，你脑子一下子就轻松了。

第二种，是 Mermaid 图。

这个真是经典痛点。Claude 特别爱输出 Mermaid，因为它确实方便表达结构关系。但在终端里看 Mermaid，其实和看源代码没啥本质区别。你知道那里有图，可你看到的不是图，而是“图的代码”。这中间有一层巨大的理解损耗。md-viewer-skill 这种工具一接进去，图直接变图，这个体验差别是真挺大。

第三种，是持续写作或持续分析。

很多时候你不是一次性让 AI 交付完，而是边生成边看，边追加边调整。终端天然不适合这种工作模式，因为它太像流水输出，不像一个可以稳定承载结果的容器。浏览器预览一开，Claude 继续写，你这边像看一个实时更新的工作面板，这种体验才开始像现代工具该有的样子。

更有意思的是，这个 Skill 的实现方式本身也很有代表性。

没有搞一堆重型通信，没有上复杂同步机制，没有为了一个预览器整出一整套工程奇观。就是一个本地服务、一个 manifest 文件、一个前端页面，靠简单轮询把内容接起来。笨吗？有点。可正因为笨，它才稳。对这类工具来说，稳定比花哨重要得多。你不是在做高频交易系统，你只是想把 Claude 刚写出来的 Markdown 正常看一眼。

这也说明一件事：很多 AI 工具真正需要的，不是再加一个多厉害的新模型，而是把现有输出链条里的那些小断口补上。谁能把这些小断口补好，谁就更容易把“看起来会生成”变成“真正能工作”。

所以我看 md-viewer-skill，不会把它当成单纯的查看器。我更愿意把它看成 AI 工具链里那个迟早要补的显示层补丁。

以前大家总说 AI 会重写软件交互，我觉得这种项目就是最实际的例子之一。不是大张旗鼓地重写一切，而是先把一个已经存在、但明显不舒服的环节换掉。Claude 继续在终端里工作没问题，可你不必继续像看日志一样去看最终产物了。

说到底，这个项目真正说明的不是“Markdown 可以预览”，而是另一件更大的事：

AI 输出越来越像结果物，终端却还把它当过程日志在展示。

而 md-viewer-skill 做的，就是在这中间补了一块很关键、也很应该早点补上的桥。

别小看这座桥。很多时候，工具体验就差这么一层。你把这层一补上，整个工作流顺得可不是一星半点。