一个干净的窗口。
不是代码编辑器。不是知识库。
没有项目、导入、工作区。
只有你要看的那份文件。
AI 存下来的报告，常常是一份 .md。同一份文件，在通用编辑器里是这样，在 mdPreview 里是那样。
在通用编辑器里
▾ docs
rag-evaluation.md
notes.md
todo.md
▾ src
eval.py
judge.py
utils.py
▸ tests
▸ node_modules
config.json
README.md
.gitignore
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 评估一个 RAG 系统
一份从原型到上线的实用指南，**大多数团队会跳过前两步**。
## 1. 先定义什么叫“好”
> **提示：** 问题集小到一个下午能读完就好。
## 2. 单独衡量检索
| 指标 | 说明什么 |
|---|---|
| Recall@5 | 证据是否在前五条里 |
```mermaid
flowchart TD
Q[用户提问] --> R[改写并向量化]1. Read rag-evaluation.md
2. Normalize headings
3. Align the table
4. Run the formatter
recall@5 0.88 mrr 0.62
warning: 2 deprecated calls
error: judge.py:41 timeout
$ git status
RestartLater
mdPreview
检索评估报告.md示意：左侧为通用编辑器界面，不指向任何具体软件。
双击就开。
设为默认打开方式，双击就是排好版的正文。不必先启动软件，再找一遍文件。
不联网，也能用。
不用账号，阅读和编辑都在本地完成。文档留在你的电脑里，不必先上传到哪里。
改一句，不换工具。
点正文，用工具条直接改。
想看源码？⌘E，随时切换。
改完，从 macOS「文件」菜单导出 PDF、Word 或网页文件，发给别人。
把 mdPreview 放进 Mac。
交给 AI，或者自己下载。
让 AI 帮你安装。
粘给能操作这台 Mac 的 AI，如 Claude Code 或 Codex。
更习惯命令行？
你可能还想问。
需要懂 Markdown 吗？
不需要。打开就能读，点击正文可以编辑，用工具条加粗、设标题、加列表。复杂内容也可以切到源码模式处理，但日常阅读和简单修改不用学习语法。
免费吗？
免费，也开源，采用 MIT 许可证。没有账号、订阅或广告。你可以在 GitHub 查看源码。
会上传我的文档吗？
不会自动上传文档，也没有云同步或遥测。阅读、编辑和导出在本地完成。自动更新会联网检查并下载新版本，可以在设置中关闭；远程图片默认不加载，由你决定是否联网加载。主动分享或打开带远程图片的导出网页，是另外的操作。
为什么 macOS 会提醒我？
目前软件没有付费完成Apple的开发者认证，浏览器下载的安装包可能触发 macOS 的首次打开保护。确认来自本项目发布页后，可在「系统设置 → 隐私与安全性」中选择「仍要打开」。官方脚本保留签名与校验和验证；如果校验失败、设备管理策略或系统阻止安装，请停止，不要绕过限制。AI 安装也不能保证系统放行，网页不会控制你的 AI。
在 Finder 里，按空格能预览吗？
应用包含 Quick Look 扩展。在 Finder 中选中文件，按空格即可尝试预览。如果没有生效，可到「系统设置 → 通用 → 登录项与扩展 → 快速查看」检查 mdPreview 扩展是否启用。不同 macOS 版本的入口和兼容性可能不同，请以发布说明为准。