davidhoo/MarkdownReader 开源项目中文解读：技术栈、适用场景与上手建议

项目介绍

davidhoo/MarkdownReader 是一个托管在 GitHub 上的开源项目，主要使用 Swift 编写，目前获得 137 个 Star、13 次 Fork。

仓库全名: davidhoo/MarkdownReader

README 摘要

简体中文 | 繁體中文 | English | 日本語 Markdown Reader 不是又一个全能编辑器，只是一个安静的阅读器。为什么选它？市面上 Markdown 工具越来越多，功能一个比一个全——实时协作、云端同步、插件生态……但很多时候，你只是想快速打开一个 .md 文件，安安静静地读完它。 Markdown Reader 就是为这个场景而生：没有心理负担 — 不注册、不登录、没有复杂配置，打开即用秒开秒读 — 原生 macOS 应用，启动快、切换快、阅读流畅专注阅读 — 三栏布局，目录树 + 渲染视图 + 大纲导航，一眼看清文档结构独立多窗口 — 原生多窗口会话，多文档并排阅读，独立撤销栈极小极轻 — DMG 安装包不到 10MB，按需加载，不占空间当你不需要写作、不需要协作、不需要花哨功能，只想快速查看 Markdown 文档时，它就是最合适的选择。功能功能 | 说明 | WebPage…

完整内容见 GitHub 原始 README 或本页。

常见问题

MarkdownReader 用什么语言开发？

主要使用 Swift 编写，目前有 137 个 Star。

如何获取 MarkdownReader 的源码？

可以直接克隆仓库：git clone https://github.com/davidhoo/MarkdownReader.git，默认分支为 main；安装与运行步骤见仓库 README。

MarkdownReader 最近还在维护吗？

仓库最近一次更新为 2 周前，当前有 2 个未关闭 Issue；Star 数为 137，可作为社区活跃度的参考。

关于

A quiet native macOS Markdown reader built with SwiftUI, cmark-gfm & WKWebView. Three-column layout with file tree, rendered markdown, and outline navigation. Mermaid, KaTeX, PlantUML, Prism.js, 33 themes, i18n, PDF export, and more.

cmark-gfm katex macos markdown markdown-reader mermaid native-app pdf-export prismjs swift swiftui theme-system wkwebview

137 Stars
13 Forks
1 Watching

描述取自 GitHub 官方 API，中文内容由 GitRead 中文社区编辑团队整理。

简要分析

热度分

164

价值分

活跃状态

活跃

GitHub

简体中文 | 繁體中文 | English | 日本語

Markdown Reader

不是又一个全能编辑器，只是一个安静的阅读器。

macOS 26+ License: MIT

为什么选它？

市面上 Markdown 工具越来越多，功能一个比一个全——实时协作、云端同步、插件生态……但很多时候，你只是想快速打开一个 .md 文件，安安静静地读完它。

Markdown Reader 就是为这个场景而生：

没有心理负担 — 不注册、不登录、没有复杂配置，打开即用
秒开秒读 — 原生 macOS 应用，启动快、切换快、阅读流畅
专注阅读 — 三栏布局，目录树 + 渲染视图 + 大纲导航，一眼看清文档结构
独立多窗口 — 原生多窗口会话，多文档并排阅读，独立撤销栈
极小极轻 — DMG 安装包不到 10MB，按需加载，不占空间

当你不需要写作、不需要协作、不需要花哨功能，只想快速查看 Markdown 文档时，它就是最合适的选择。

功能

功能	说明
WebPage 渲染引擎	cmark-gfm + WebPage（macOS 26 原生）渲染，完整 GFM 扩展语法
平滑模式切换	基于小数源码锚点管线，渲染视图与原文编辑无缝切换，精确定位不跳行、不白屏
双图表引擎可选	支持经典 Mermaid.js 与原生轻量 Pele 引擎，同一段 ````mermaid` SVG 配色深度融入主题
PlantUML 图表	支持 PlantUML 语法，自动渲染为 SVG 图表（需要网络）
数学公式	KaTeX 渲染 LaTeX 行内和块级公式，按需轻量加载
Prism.js 代码高亮	30+ 语言语法高亮，Prism.js 引擎
实时编辑与源码行号	原文模式直接编辑，Cmd+S 保存；可选显示源码行号（Gutter），自适应宽度
原生多窗口	支持多窗口独立会话（`Shift+Cmd+N`），独立撤销栈（Per-window Undo），文档并排查阅
智能目录树	递归浏览文件夹，支持目录软链接（Symlink）与实时文件变动监听；支持打开单文档时自动列出所在目录
大纲导航	自动提取标题层级，点击平滑滚动并统一定位至视口顶部，阅读长文档更高效
Quick Look 预览	Finder 中选中 .md 文件按空格即可预览渲染效果，无需打开应用
整篇内容复制	渲染模式、原文模式与 Quick Look 可一键复制整篇内容；设置可统一关闭，Quick Look 可选富文本或原始 Markdown
按需轻量加载	Mermaid/Pele、KaTeX 等可选运行时仅在文档需要时加载，普通 Markdown 零多余内存开销
33 套主题	20 深色 + 13 浅色，含 Markdown Preview Enhanced 风格主题，支持自定义配色和对比度调节
多语言	简体中文、繁体中文、英文，自动跟随系统
命令行工具	`mdr` 命令从终端直接打开 Markdown 文件或目录
命令面板	`Cmd+P` 快速搜索并打开目录树中的文件
窗口恢复与系统同步	记住上次浏览位置，智能路径规范化去重，并与 macOS 系统「最近使用的项目」双向同步

快捷键

快捷键	功能
`Cmd+N`	新建文件
`Shift+Cmd+N`	新建窗口
`Cmd+O`	打开目录 / 文件
`Cmd+S`	保存文件
`Shift+Cmd+S`	另存为
`Cmd+Option+E`	导出 PDF
`Cmd+W`	关闭窗口
`Cmd+,`	打开设置
`Cmd+\`	切换侧边栏
`Cmd+Shift+E`	渲染模式
`Cmd+Shift+R`	原文模式
`Cmd++`	放大
`Cmd+-`	缩小
`Cmd+0`	实际大小
`Cmd+F`	查找
`Cmd+G`	查找下一个
`Cmd+Shift+G`	查找上一个
`Cmd+Option+F`	查找与替换
`Cmd+P`	命令面板
`Cmd+?`	帮助

安装

下载安装

前往 Releases 下载最新版 DMG，拖入应用程序文件夹即可。

Homebrew（可选）

也可以通过自建 Tap 用 Homebrew 安装：

brew tap davidhoo/markdownreader
brew install --cask markdownreader

# 升级（因应用自带更新，需加 --greedy 才由 Homebrew 拉取新版）
brew update
brew upgrade --cask --greedy markdownreader

Homebrew 只负责安装与可选升级；应用仍保留既有 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 — 基于文本的图表生成（流程图、时序图、甘特图等）
Pele — 轻量矢量 SVG Mermaid 图表渲染引擎
Prism.js — 轻量级代码语法高亮
PlantUML — 开源 UML 图表渲染

特别感谢 linux.do 社区的反馈与支持。

MIT License

暂无评论

MarkdownReader