Markdown Preview:原生、轻量的 macOS Markdown 阅读器
Markdown Preview 是一款运行在 macOS 上的 Markdown 文件阅读工具,不提供编辑功能,只做预览。基于 WKWebView 和 swift-markdown 原生渲染,支持 Quick Look、Mermaid 图表、LaTeX 公式,完全免费开源。

Markdown Preview 是一款专为 macOS 打造的 Markdown 阅读工具。将 .md 文件拖到应用图标,或者将它设为默认打开方式,就能获得排版整洁、支持滚动和目录导航的文档预览,无需 Electron,也不必额外打开浏览器标签页。
虽然它以阅读体验为核心,但也提供了轻量编辑、Finder 快速查看以及与常用编辑器和 AI 应用衔接的能力,适合阅读项目 README、技术文档、会议记录和 AI 生成的 Markdown 内容。GitHub 项目说明
核心功能
-
原生 macOS 体验:采用 AppKit 构建,工具栏、快捷键和窗口交互方式与系统应用保持一致,启动后可以直接打开 Markdown 文件。
-
文档目录:自动根据标题生成侧边栏目录,点击即可跳转到对应章节,阅读较长的 README 或技术文档时更加方便。
-
Finder 快速查看:内置 Quick Look 扩展,在 Finder 中选中
.md文件并按下空格,即可直接查看排版后的内容,Spotlight 和邮件附件也能使用相同的预览能力。 -
轻量编辑模式:按下
⌘E可以原地编辑 Markdown,并通过格式工具栏插入标题、粗体、列表、引用、代码和链接;完成后使用⌘S保存。 -
Mermaid 与数学公式:支持渲染 Mermaid 图表、行内 LaTeX、块级公式和
math代码块。相关渲染组件已经随应用打包,离线环境下也能正常使用。 -
搜索与缩放:支持文档内搜索、查找上一个或下一个结果,以及通过触控板、工具栏或快捷键调整文字大小。
-
连接常用编辑器:可以将当前文件发送到 VS Code、Cursor、Zed、Sublime Text、BBEdit、Xcode 和 TextEdit 等编辑器,并记住上一次选择。
-
在 AI 应用中打开:工具栏可以将当前 Markdown 文件发送到 Codex、Claude 或 ChatGPT;分享功能则会传递 Markdown 原始文本,方便继续整理或改写内容。
-
命令行支持:可以从应用菜单安装
mdp、md-preview和markdown-preview命令,随后通过终端打开单个文件或整个文件夹,例如:
12mdp README.md mdp .
支持的文件类型
Markdown Preview 可以打开以下文件:
.md.markdown.mdown.txt
系统要求
- macOS 15 或更新版本
- 支持 Apple Silicon 和 Intel Mac
安装
Markdown Preview 已进入 Homebrew 官方 Cask 仓库,可以通过下面的命令安装:
1brew install --cask markdown-preview
也可以前往 GitHub Releases 下载已经签名并完成 Apple 公证的 DMG 安装包。
Markdown Preview 免费开源,采用 MIT 许可证。正式版本会发送经过限制的匿名崩溃报告,但不会收集文档内容、文件路径、用户信息、网络请求或使用轨迹,并且可以在应用设置中完全关闭。隐私与源代码说明


