davidhoo/MarkdownReader：使用SwiftUI、cmark-gfm和WKWebView构

项目介绍

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

仓库全名: davidhoo/MarkdownReader

README 摘要

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

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

常见问题

MarkdownReader 用什么语言开发？

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

如何获取 MarkdownReader 的源码？

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

MarkdownReader 最近还在维护吗？

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

关于

GitHub 原始描述（英文）

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

138 Stars
13 Forks
1 Watching

描述取自 GitHub 官方 API，保持仓库作者书写的原文。

简要分析

热度分

165

价值分

活跃状态

活跃

GitHub

语言占比

CSS

HTML

JavaScript

Python

Ruby

SCSS

Shell

Swift

Release

v2.4.113 周前
v2.4.103 周前
v2.4.93 周前
v2.4.810月9日
v2.4.79月22日

贡献者

简体中文 | 繁體中文 | 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