打开文件,开始阅读,就这么简单
按 ⌘O 选择文件,或按 ⇧⌘N 新建独立窗口。支持拖拽文件/文件夹直接打开。
左侧目录树,中间内容区,右侧大纲导航。按 ⇧⌘E / ⇧⌘R 在渲染与源码间平滑切换,阅读位置精准保持。
在原文模式中直接编辑,⌘S 保存;可在设置中开启源码行号,长文编辑清晰有序。
按 ⌘P 打开命令面板,输入文件名模糊搜索,↑↓ 选择,Enter 打开。比浏览目录树更快。
键盘操作更高效
| 快捷键 | 功能 |
|---|---|
| ⌘N | 新建文件 |
| ⇧⌘N | 新建窗口 |
| ⌘O | 打开目录 / 文件 |
| ⌘S | 保存文件 |
| ⇧⌘S | 另存为 |
| ⌥⌘E | 导出 PDF |
| ⌘W | 关闭窗口 |
| ⌘, | 打开设置 |
| ⌘\ | 切换侧边栏 |
| ⇧⌘E | 渲染模式 |
| ⇧⌘R | 原文模式 |
| ⌘+ | 放大 |
| ⌘- | 缩小 |
| ⌘0 | 实际大小 |
| ⌘F | 查找 |
| ⌘G | 查找下一个 |
| ⇧⌘G | 查找上一个 |
| ⌥⌘F | 查找与替换 |
| ⌘P | 命令面板 |
| ⌘? | 帮助 |
每个功能都为阅读体验而生
cmark-gfm 引擎解析 Markdown,WebPage(macOS 26 原生)渲染为富文本。支持完整 GFM 扩展语法,包括表格、任务列表、删除线、自动链接等。
基于小数源码锚点管线(SourceScrollAnchor),在渲染模式与原文模式之间切换时精确保留阅读位置,不跳行、不白屏。
按 ⇧⌘R 直接编辑 Markdown 源码,Prism.js 高亮 30+ 语言。可在外观设置中开启源码行号(Gutter),自适应宽度且滚动平稳。
按 ⇧⌘N 可新建独立窗口,支持同时打开多个文档或目录;每个窗口拥有独立的编辑状态与撤销栈(Per-window Undo)。
递归浏览文件夹,完整支持目录软链接(Symlink)与源目录变动监听。支持「打开单文档时自动在侧边栏浏览所在目录」。
自动提取标题层级结构,点击平滑滚动并统一定位至视口顶部,阅读长文档更高效。
按 ⌘F 打开查找栏。支持区分大小写、全词匹配、正则表达式。⌥⌘F 打开查找与替换。
使用 ⌘+ / ⌘- 缩放内容,范围 0.3x–3.0x。按 ⌘0 恢复实际大小,缩放级别自动恢复。
按 ⌘P 打开命令面板,输入文件名快速搜索并打开目录树中的 Markdown 文件。支持模糊匹配和键盘导航(↑↓ 选择,Enter 打开)。
33 套主题,打造你的阅读空间
在设置 → 外观中,可选择浅色、深色或跟随系统三种模式,应用立即切换外观。
33 套预设配色(20 深色 + 13 浅色),Dracula、Catppuccin、Nord、Tokyo Night……每种模式有独立配色。
在设置 → 外观 → 自定义颜色中,可单独调整背景色、文字色、强调色、成功色、危险色。
提供低/高两档对比度选项,调整背景与前景层之间的视觉对比。
技术文档的完美渲染
在代码块中使用 `mermaid` 标识。可在通用设置中切换图表引擎:默认 Mermaid.js 保持经典布局,可选 Pele 引擎输出与主题深度融合变色的原生 SVG。本地渲染,无网络依赖。
使用 `$...$` 包裹行内公式,`$$...$$` 包裹块级公式。LaTeX 语法完美呈现,且仅在正文包含公式时按需加载运行时。
在代码块中使用 `plantuml` 语言标识,自动渲染为 SVG 图表。需要网络连接。
终端工作流无缝衔接
打开 设置 → 通用 → 命令行工具,开启开关即可安装。安装完成后,`mdr` 命令可在终端直接调用。
终端输入 `mdr README.md` 即可打开文件,支持同时打开多个文件和文件夹。
还有这些贴心功能等你发现
在 Finder 中选中 .md 文件按空格,即可预览渲染效果。需在 设置 → 通用 → Quick Look 预览 中启用。
渲染模式、原文模式与 Quick Look 均可一键复制整篇内容;在 设置 → 通用 中可统一关闭三处复制入口。Quick Look 开启时可选择复制为富文本或原始 Markdown。
按 ⌥⌘E 或使用菜单 文件 → 导出 PDF,将渲染内容导出为 PDF 文件,保留当前主题样式。
遇到问题?先看看这里
支持 `.md`、`.markdown`、`.mdown`、`.mkd` 等 Markdown 格式文件。
macOS 26 (Tahoe) 或更高版本,原生支持 Apple Silicon。
终端运行 `brew tap davidhoo/markdownreader && brew install --cask markdownreader` 即可安装。升级时使用 `brew upgrade --cask --greedy markdownreader`。
MarkdownReader 是开发者签名的开源应用,未加入 Apple Developer 付费公证。首次启动若被 Gatekeeper 拦截,请在「应用程序」中按住 Control 点击应用图标并选择「打开」,或进入「系统设置 > 隐私与安全性」点击「仍要打开」。
PlantUML 渲染需要网络连接,请确保可以访问 PlantUML 服务器。离线环境下 Mermaid / Pele 图表均可完全本地渲染。
打开 设置 → 通用 → 默认 Markdown 打开程序,点击「设为默认」即可。也可以右键 .md 文件 → 显示简介 → 打开方式 → 选择 Markdown Reader → 点击「全部更改」。
欢迎在 GitHub Issues 中提交反馈与 Pull Request。