如何在 Mac 上复查 AI 生成的 Markdown 和 HTML

原文：https://indieseek.co/zh/blogs/read-ai-markdown-html-on-mac/

如何在 Mac 上复查 AI 生成的 Markdown 和 HTML

现在的 AI coding 工具不只改代码。它们还会留下方案、报告、release note、handoff 文档、Mermaid 图和 HTML 预览。

这些文件通常很有用，但它们会直接落在真实项目目录里。旁边就是源码、配置、依赖、构建产物、截图和旧草稿。

打开一个 Markdown 很容易。打开一个 HTML 也很容易。麻烦的是：agent 做完一轮任务后，你要把这一堆生成文件一起复查清楚。

这是我现在常用的复查方法。

先从目录看起

不要一个文件一个文件乱点。先打开项目目录，看最近有哪些文档变了。

我通常先问几个问题：

  • 这次任务改了哪些 Markdown 和 HTML？
  • 哪些文件像方案、报告、总结或交接文档？
  • 哪些文件里有图、表格、截图或 HTML 预览？
  • 哪些只是旧草稿或生成噪音？

这样能让复查贴着真实任务走，也能避免一开始就被某个过期文件带偏。

不同工具用在不同场景

VS Code 仍然适合写代码。浏览器适合快速打开一个 HTML。Finder 适合看文件名和目录。

问题出现在一个 agent 任务生成了好几份文档的时候。

这时我不需要另一个编辑器。我需要的是一个安静的阅读界面：

打开目录 -> 筛出 Markdown 和 HTML -> 阅读渲染后的文档 -> 安全预览 HTML -> 决定保留、修改还是忽略

这就是本地 Markdown/HTML 阅读器适合解决的小问题。

我的复查顺序

当一个任务生成多份文件时，我会按这个顺序看：

  • 打开项目目录。
  • 只筛 Markdown 和 HTML。
  • 先看最近修改的文档。
  • Markdown 用渲染后的形态读，不直接读 raw text。
  • HTML 用受控的本地预览打开。
  • 搜 TODO、TBD、draft、fix later、待确认 这类标记。
  • 每份文件只做一个判断：保留、修改、忽略。

    • 目标不是收藏 agent 生成的每个文件，而是尽快做出人的判断。

    分享前我会检查什么

    把 AI 生成的文档发给别人之前，我会检查这些点：

    • 文档有没有说清它支持什么决策或动作？
    • 代码路径、日期、URL、数字和产品名是否还正确？
    • 只扫标题能不能看懂主要意思？
    • 链接、图片、本地引用和图表能不能打开？
    • HTML 预览有没有依赖缺失或不安全资源？
    • 有没有暴露本地路径、私人笔记、密钥、客户数据或内部信息？
    • 状态是否清楚：最终稿、草稿，还是仍在待确认？

    这很重要。生成文档可能写得很顺，但里面仍然可能有旧名称、断链或隐藏假设。

    什么时候需要专门的阅读器

    当 Markdown 和 HTML 需要放在一起复查，尤其是它们混在代码目录里时，专门的阅读器会很有用。

    MD+HTML Reader 就是为这个场景做的。它可以打开本地目录，筛出 Markdown 和 HTML，只读渲染 Markdown，在 sandbox frame 里预览 HTML，并把最近文档放在手边。

    它不是为了替代编辑器或浏览器。它只想把复查这一步变得安静一点。

    一个简单判断

    如果只是编辑一份 Markdown，我用编辑器。

    如果只是打开一个 HTML，我用浏览器。

    如果 AI agent 在真实项目目录里生成了一组 Markdown 和 HTML，我会把它们当成一组文档一起复查。

    这个小变化能少翻很多目录。

    来源和相关资源

    posted @ 2026-07-07 20:16  IndieSeek  阅读(2)  评论(0)    收藏  举报