由文件树、渲染文档和大纲组成的三栏 Mac Markdown 阅读工作区概念插画。

Markdown Reader:用三栏界面阅读 Markdown 的 macOS 应用

把文件树、渲染后的文档和标题大纲放在同一窗口。Markdown Reader 是一款面向 Apple 芯片 Mac 的原生应用,可阅读并编辑本地 Markdown 文件。

要点摘要
  • 用三栏并排展示递归文件树、渲染后的 Markdown 文档和可点击的标题大纲。
  • 支持 GitHub Flavored Markdown、Mermaid、KaTeX、Prism、33 款主题、Quick Look 和 PDF 导出;PlantUML 需要联网。
  • 可以编辑 Markdown 源码和管理本地文件,但它不是多人协作或云端同步编辑器。
  • 当前官方 v2.4.7 面向 macOS 26 及更新版本和 Apple 芯片。应用有开发者签名但未经公证,采用 MIT 许可证。

三栏布局让长篇 Markdown 更容易浏览

Markdown Reader 把文件夹树、渲染后的文档和标题大纲并排显示。你可以从文件树中选择文档,在中间阅读排版后的内容,再通过大纲直接跳到目标章节;阅读长文时,文档结构始终清晰可见。

它的定位更接近专注阅读的工具,而不是包罗万象的写作套件:快速打开本地 .md 文件,同时让文件夹和标题导航保持在手边。

丰富的渲染功能,但有一项需要联网

应用结合 cmark-gfm 和 macOS 原生 WebPage 渲染 GitHub Flavored Markdown,包括表格和任务列表。代码由 Prism 高亮,LaTeX 公式则交给 KaTeX 显示。

Mermaid 图表可在本地渲染。Mermaid、KaTeX 等可选运行时会在文档需要时再加载,因此普通 Markdown 页面不必一开始就载入所有组件。

项目也支持 PlantUML,但明确说明它需要网络连接。因此,虽然它适合浏览本地文档,却不能说所有渲染功能都完全离线。

不只是只读预览,也能编辑源码

切换到源码模式后,可以直接编辑 Markdown,并用 Cmd+S 保存。根据项目说明,在切换文件时尚未保存的内容会保留,因此浏览同一文件夹时不必丢下正在编辑的草稿。

文件树还可以新建、重命名和删除文件。这些操作会直接影响你打开的本地文件,所以它更像轻量文件工作区,而不只是只读查看器。

项目文档描述的使用流程无需注册或登录;但 Markdown Reader 并非实时协作编辑器。它主要用于打开、阅读和编辑 Mac 上的文件,而不是同步团队工作区。

Finder Quick Look 与键盘导航

在 Finder 中选中 Markdown 文件并按空格键,即可通过 Quick Look 预览文档,不必打开主窗口。还可以复制整篇文档,并在设置中选择复制富文本还是原始 Markdown。

在应用内,Cmd+P 打开命令面板,大纲可直接定位到标题;查找、查找下一个和查找上一个也都有常用快捷键。重新打开应用时,它还会记住上次浏览的位置。

如果要在应用外查看或分享文档,可以按 Cmd+Option+E 导出 PDF。它适合生成一份稳定的审阅副本,但不是发布或团队协作服务。

主题与语言选项,让阅读更舒服

项目列出了 33 款主题,其中 20 款深色、13 款浅色,并允许自定义颜色和对比度。你可以按阅读习惯调整界面,而不必修改源文档。

应用界面会跟随系统语言,项目列出的界面语言包括简体中文、繁体中文和英语。仓库里有多种语言的 README,并不代表应用界面也支持同样多的语言。

从官方 Release 安装 v2.4.7

下载官方 v2.4.7 DMG或ZIP 压缩包,再将 Markdown Reader 移入“应用程序”文件夹。项目也维护了官方 Homebrew tap 和 cask。

brew tap davidhoo/markdownreader
brew install --cask markdownreader

当前版本要求 macOS 26(Tahoe)或更新版本,并面向 Apple 芯片。应用经过开发者签名,但尚未公证,因此 macOS 首次打开时可能会拦截。项目建议按住 Control 键点按应用并选择“打开”,或在系统设置的“隐私与安全性”中选择“仍要打开”;项目没有建议使用终端命令绕过 Gatekeeper。

MIT 许可证与项目链接

Markdown Reader 是采用 MIT 许可证的开源软件。更多信息见项目仓库与 README、v2.4.7 Release、Homebrew cask和官方网站。

项目概况

许可证
MIT
平台
macOS 26 (Tahoe)+; Apple Silicon release
开发语言
Swift and SwiftUI with cmark-gfm, WebPage and WKWebView
查看版本
v2.4.7 (official release checked 2026-09-24)

安装

open https://github.com/davidhoo/MarkdownReader/releases/latest/download/MarkdownReader.dmg

许可说明

Markdown Reader 使用宽松的 MIT 许可证发布。分发软件副本或重要部分时,应保留版权声明和许可证文本;软件按“现状”提供,不附带保证。