MacDown2.0 应用图标
v0.2.2 · Swift 6 · SwiftUI · TextKit 2

Markdown,回归 Mac 原生。
从零重写。

MacDown 的新版精神续作:用 Swift 为 macOS 26 写成的免费开源 Markdown 编辑器,原生支持苹果芯片。左边是深色源码,右边是实时预览,边打字边在毫秒间刷新。

下载 .dmg
$ brew install --cask xuanji86/tap/macdown2
macOS 26+ 支持苹果芯片(M1–M5)与 Intel 免费开源
MacDown2.0 正在编辑一份 Markdown 文档:左边是深色编辑区里的源码,右边是实时预览,含 GitHub 提示块、任务列表、表格、Swift 代码高亮、KaTeX 公式和 Mermaid 图表
7.5 ms
1 MB 文档单次按键的预览更新耗时。MacDown 0.7.3 需要 78.5 ms。
4 ms 对 ~500 ms
页面上有 200 个公式时,与 MacDown 0.7.3 的对比。
0 次整页重载
增量渲染:只重新渲染改动过的部分,不重新载入整页。
技术

建在现代 Mac 技术栈上的原生 Markdown 编辑器。

MacDown2.0 与 MacDown 共享的是一种理念,而不是代码。每一层都是为今天的 Mac 选的。

Swift 6 + SwiftUI
原生应用代码,使用 Swift 6 语言模式与严格并发检查,界面用 SwiftUI 编写。
语言 · 界面
TextKit 2
编辑器运行在 Apple 当前的文本引擎上。
编辑器
tree-sitter
增量语法高亮:一次编辑只重新解析它碰到的部分。
高亮
markdown-it, incremental
预览只重新渲染改动过的段落,直接修补到页面上,从不整页重载。
渲染器
macOS 26
为当前系统版本而做:Liquid Glass 与五种 Dock 图标样式。
平台
通用二进制
原生支持苹果芯片(M1 到 M5),无需 Rosetta;同一个下载也能在 Intel Mac 上运行。更新由 Sparkle 负责。
分发
性能

实时预览的速度:实测,不是承诺。

一次编辑之后更新预览所需的时间(含布局),与 MacDown 0.7.3 对比,越低越好。

场景 MacDown2.0 MacDown 0.7.3 快
12.6 KB 文档3.1 ms8.6 ms2.8×
50 KB 文档3.2 ms10.7 ms3.3×
1 MB 文档7.5 ms78.5 ms10×
200 个公式4.1 ms495.5 ms121×
300 个代码块3.8 ms48.3 ms13×

每次编辑后预览更新耗时的中位数,含布局。测试机器:Apple M5 Pro,macOS 27.2。离屏测量:从编辑发生到预览完成布局计时,预览在下一个显示帧绘制。MacDown 0.7.3 每次按键都会重新载入整页;MacDown2.0 只重新渲染改动过的部分。

功能

左边写 Markdown,右边看实时预览。

可交互的预览

在预览里勾选任务框,Markdown 源码随之改写。编辑区与预览双向同步滚动。

GitHub 风格 Markdown

GFM 表格、任务列表、脚注、GitHub 提示块和 ==高亮==。

公式、代码与图表

KaTeX 公式、highlight.js 代码高亮和 Mermaid 图表。

Front matter

支持 YAML 或 TOML front matter,可隐藏或显示为表格。

对中文友好的强调

加粗、斜体紧贴中文标点也能正确识别。

工作区

Finder 风格的文件树、标签页、整个文件夹的全文搜索,以及大纲。

文字编码

UTF-8、UTF-16、GB18030、Shift_JIS、Windows-1252、Mac Roman。别的程序改了文件会自动重新载入。

安全导出

HTML、分页 PDF 和打印。导出的 HTML 经过净化。

Quick Look

在 Finder 里按空格,直接看到渲染后的效果。

Quarto

近似预览 callout、分块和交叉引用。代码单元只高亮,不执行。

主题

编辑器 7 套、预览 8 套,各自独立选择,也可以跟随系统深浅色。

双语界面

中英文界面,可按应用单独设置语言。

工作区

把文件夹当作 Markdown 工作区,跨文件工作。

侧栏用的是 Finder 同款图标,编辑区上方是标签页,可对整个文件夹做全文搜索(可开正则),另有当前文档的大纲。

⇧⌘O 打开文件夹⇧⌘F 搜索⌘N 新建
MacDown2.0 打开了一个工作区文件夹:侧栏显示整个文件夹的全文搜索结果,编辑区上方有三个标签页,右边是预览
命令行

macdown2:在终端里把 Markdown 渲染成 HTML 与 PDF。

在应用里打开文件和文件夹,或者无头渲染 HTML 与 PDF,不需要窗口,也没有 Dock 图标。Homebrew cask 会帮你装好。

zsh
$ macdown2 notes.md docs/# 文件夹以工作区打开
$ macdown2 .# 当前文件夹
$ cat draft.md | macdown2# 打开管道输入
$ macdown2 render a.md --standalone -o a.html# 无头渲染
$ macdown2 render a.md --export pdf -o a.pdf# 无需窗口

下载 MacDown2.0(Mac 版)

下载 .dmg
$ brew install --cask xuanji86/tap/macdown2

需要 macOS 26 或更新版本;一个版本同时支持 Apple Silicon 与 Intel。免费开源。应用未经公证:手动下载的版本第一次打开时,请到「系统设置 › 隐私与安全性」点「仍要打开」。用 Homebrew cask 安装则会自动清除隔离标记。README 里的安装说明