开始使用 Claude Code 或 Codex 这类 AI 智能体后，电脑里的“.md”文件会一下子多起来：写给智能体指示的 CLAUDE.md，还有智能体整理的调查结果和工作计划。它们都是用名为 Markdown 的写法写成的文本文件。
可是，.md 文件双击后常常没法整洁地打开。本文面向使用 AI 智能体的人，介绍用于阅读和修改 .md 文件的 Mac 和 Windows 应用 Markdocx。
AI 智能体用 .md 文件沟通
和 AI 智能体打交道时，.md 文件既用作“指示”，也用作“成果”。
给智能体的指示
Claude Code 每次开始工作时都会读取 CLAUDE.md。把工作步骤、希望它遵守的规则、文章的写法等写进去，就不必每次都重新说明。
| 文件 | 读取它的智能体 | 作用 |
|---|---|---|
| 项目文件夹中的 CLAUDE.md | Claude Code | 该项目中的指示。可以用 /init 命令生成第一版 |
| ~/.claude/CLAUDE.md | Claude Code | 适用于所有项目的个人偏好 |
| AGENTS.md | Codex（Claude Code 也能读取） | 项目中的指示 |
~/.claude 是主文件夹中的隐藏文件夹。在 Mac 的“访达”中，按 Command + Shift + .（句点）即可显示隐藏文件夹。
指示文件并不是写一次就结束了。要一边观察智能体的表现一边重读、补充，让它慢慢完善。
来自智能体的成果
调查报告、工作计划、变更摘要、README……交给智能体的工作，结果也常常以 .md 文件的形式送来。Markdown 用符号写标题、列表和表格，AI 写起来方便，人也容易看清结构。在说明处理流程或结构时，智能体还经常用一种叫 Mermaid 的写法加入图表。
可是，.md 文件不好读
.md 文件是用“#”表示标题、“**”表示粗体、“|”表示表格的文本。可是，双击就能把它整理好显示出来的应用，意外地少。
- 在 Mac 上，它会在“文本编辑”等应用中带着符号打开，或者打开面向开发者的应用
- Windows 11 的记事本已经可以显示标题、粗体、项目列表等简单格式。但智能体成果中常见的表格、代码着色和 Mermaid 图表，不在它的显示范围内
想整洁地阅读，就得把内容粘贴到网页服务里，或者在面向开发者的编辑器中打开预览，多花一番功夫。智能体每次工作都会送来报告，每次都这样读很辛苦。修改 CLAUDE.md 时，也只能直接改写满是符号的文本。
用 Markdocx，双击就能阅读，还能直接修改
Markdocx 是一款 Mac 和 Windows 应用，打开 .md 文件就会立刻显示成整洁的文档。把 Markdocx 设为打开 .md 文件的应用后，以后只要双击即可。设置方法请参阅介绍打开 .md 文件的应用的文章。
把智能体的成果当作整洁的文档阅读
- 标题、列表、表格、任务列表和引用都会整齐地显示，代码按语言着色
- Mermaid 图表会直接显示成图表。支持流程图、时序图等 10 种，在电脑中绘制，不联网也能查看
- 左侧的大纲中列出标题，即使是长篇报告也能马上跳到想读的地方
一边看预览，一边修改 CLAUDE.md
- 编辑器和预览可以并排显示，输入的内容会立刻反映到预览中。可以一边确认按标题整理的指示结构，一边补充内容
- 可以从格式工具栏插入粗体、链接、表格、列表等，不必记住所有 Markdown 写法
- 自动保存，.md 文件仍以 .md 保存。修改后的 CLAUDE.md 或 AGENTS.md，智能体下次工作时就会直接读取
把成果导出为 Word 或 PDF 交给别人
有时你想把智能体整理的报告交给不用 AI 的同事或客户。用 Markdocx，从工具栏的导出按钮即可导出为 Word（.docx）或 PDF。标题、表格和代码原样保留，Mermaid 图表以图片形式放入，收到的人只用 Word 就能看到图表。详情请参阅介绍 Mermaid 和导出为 Word 的文章。
阅读和修改，一直免费
Markdocx 可以从 Mac App Store 和 Microsoft Store 获取。前 14 天可以使用全部功能，之后打开、阅读、修改 .md 文件等功能依然可以无限期免费使用，也不需要注册账户。导出为 Word、PDF 等格式，需一次性购买后解锁。不是订阅制。
Mac 版适用于 macOS 26 或更高版本，Windows 版适用于 Windows 11 和 Windows 10（版本 1809 或更高）。
