Markdown Reader
不是又一个全能编辑器，只是一个安静的阅读器。!screenshot
为什么选它？
市面上 Markdown 工具越来越多，功能一个比一个全——实时协作、云端同步、插件生态……但很多时候，你只是想快速打开一个 .md 文件，安安静静地读完它。
Markdown Reader 就是为这个场景而生：
- 没有心理负担 — 不注册、不登录、没有复杂配置，打开即用
- 秒开秒读 — 原生 macOS 应用，启动快、切换快、阅读流畅
- 专注阅读 — 三栏布局，目录树 + 渲染视图 + 大纲导航，一眼看清文档结构
- 极小极轻 — DMG 安装包不到 10MB，不占空间
功能
| 功能 | 说明 |
|------|------|
| WebPage 渲染引擎 | cmark-gfm + WebPage（macOS 26 原生）渲染，完整 GFM 扩展语法 |
| Mermaid 图表 | 流程图、时序图、甘特图等 Mermaid 图表本地渲染 |
| PlantUML 图表 | 支持 PlantUML 语法，自动渲染为 SVG 图表（需要网络） |
| 数学公式 | KaTeX 渲染 LaTeX 行内和块级公式 |
| Prism.js 代码高亮 | 30+ 语言语法高亮，Prism.js 引擎 |
| Quick Look 预览 | Finder 中选中 .md 文件按空格即可预览渲染效果，无需打开应用 |
| 整篇内容复制 | 渲染模式、原文模式与 Quick Look 可一键复制整篇内容；设置可统一关闭，Quick Look 可选富文本或原始 Markdown |
| 实时编辑 | 原文模式直接编辑，Cmd+S 保存，切换文件自动保留未保存内容 |
| 目录树 | 递归浏览文件夹，键盘导航，右键新建/重命名/删除 |
| 大纲导航 | 自动提取标题层级，点击跳转，阅读长文档更高效 |
| 按需加载 | Mermaid、KaTeX 等可选组件仅在文档需要时加载，普通 Markdown 阅读更轻快 |
| 33 套主题 | 20 深色 + 13 浅色，含 Markdown Preview Enhanced 风格主题，支持自定义配色和对比度调节 |
| 多语言 | 简体中文、繁体中文、英文，自动跟随系统 |
| 命令行工具 | mdr 命令从终端直接打开 Markdown 文件 |
| 命令面板 | Cmd+P 快速搜索并打开目录树中的文件 |
| 窗口恢复 | 记住上次浏览位置，重新打开自动还原 |
快捷键
| 快捷键 | 功能 |
|--------|------|
| Cmd+O | 打开目录 / 文件 |
| Cmd+N | 新建文件 |
| Cmd+S | 保存文件 |
| Cmd+Option+E | 导出 PDF |
| Cmd+, | 打开设置 |
| Cmd+\ | 切换侧边栏 |
| Cmd+Shift+E | 渲染模式 |
| Cmd+Shift+R | 原文模式 |
| Cmd++ | 放大 |
| Cmd+- | 缩小 |
| Cmd+0 | 实际大小 |
| Cmd+F | 查找 |
| Cmd+G | 查找下一个 |
| Cmd+Shift+G | 查找上一个 |
| Cmd+Option+F | 查找与替换 |
| Cmd+P | 命令面板 |
安装
下载安装
前往 Releases 下载最新版 DMG，拖入应用程序文件夹即可。
Homebrew（可选）
也可以通过自建 Tap 用 Homebrew 安装：
brew tap davidhoo/markdownreader
brew install --cask markdownreader
升级（因应用自带更新，需加 --greedy 才由 Homebrew 拉取新版）
brew update
brew upgrade --cask --greedy markdownreaderHomebrew 只负责安装与可选升级；应用仍保留既有 DMG 直装和应用内更新方式，互不影响。
关于未公证应用：MarkdownReader 是开发者签名但未公证（未购买 Apple Developer Program）。无论用哪种方式安装，首次启动若被 macOS 拦截，请在「应用程序」中按住 Control 点击 MarkdownReader，选择「打开」并在弹窗中确认；或进入「系统设置 > 隐私与安全性」，点击「仍要打开」。本仓库不提供绕过 Gatekeeper 的命令。
系统要求
macOS 26 (Tahoe) 或更高版本。
官方网站
https://davidhoo.github.io/MarkdownReader/
致谢
Markdown Reader 的构建离不开以下开源项目：
- cmark-gfm — GitHub Flavored Markdown 解析与渲染引擎
- swift-markdown — Apple 的 Swift Markdown 解析库（基于 cmark-gfm）
- KaTeX — 高速 LaTeX 数学公式渲染
- Mermaid — 基于文本的图表生成（流程图、时序图、甘特图等）
- Prism.js — 轻量级代码语法高亮
- PlantUML — 开源 UML 图表渲染
MIT License