Markdown Buddy › 在 Mac 上用快速查看阅读 Markdown

在 Mac 上用快速查看阅读 Markdown

macOS 在快速查看中把 .md 文件当作纯文本显示：井号、星号、用竖线拼出来的表格。Markdown Buddy 会安装一个快速查看扩展，改为显示排版后的文档。按一下空格键，就能看到包含标题和代码块的完整页面。

开启预览

1. 从 Mac App Store 安装 Markdown Buddy 并先运行一次。只有承载扩展的应用运行过一次，macOS 才会注册这个快速查看扩展。
2. 打开系统设置，进入通用，再进入登录项与扩展，确认快速查看下方的 Markdown Buddy 已启用。
3. 在访达中选中一个 .md 文件并按空格键。排版后的文档会取代纯文本。

预览会显示什么

快速查看面板与应用使用同一个渲染引擎，不会有任何简化：

• 标题、粗体、斜体、链接、图片和引用
• 带语法高亮的代码块
• 表格、任务列表和删除线
• Mermaid 图表与 KaTeX 公式
• YAML 前置数据，以面板形式呈现，而不是散落的文字

访达中的缩略图

同一个安装包还会附带缩略图扩展。你的 .md 文件不再像一张白纸：图标视图、分栏视图和画廊视图都会显示渲染后文档的开头，让一整个笔记文件夹一眼可读。

如果预览一片空白

• 先运行一次 Markdown Buddy 再关闭。从未运行过的扩展不会在 macOS 中注册。
• 在系统设置的通用、登录项与扩展、快速查看一栏中，确认扩展已勾选。
• 在终端执行 qlmanage -r 重建快速查看缓存，然后注销并重新登录。macOS 对这类注册信息缓存得很顽固。
• 确认文件扩展名确实是 .md。被识别为纯文本的文件由系统预览器接管，而不是我们的扩展。