按空格键,用快速查看阅读 Markdown

在访达中对 Markdown 文件按空格键,用快速查看直接读到渲染后的预览。MD Flow 为 Mac 的快速查看加入真正的 Markdown 预览,随应用免费提供。

在 Mac 上,对几乎任何文件按空格键,都能看到文件内容。可对 .md 文件按下去,macOS 显示的却是源码:# Heading、**bold**、反引号,一样不少。系统把 Markdown 归为一种纯文本,交给纯文本预览器处理,而那个预览器做的正是它被设计来做的事。

MD Flow 替换了这个预览。安装应用后,快速查看会按应用里的方式渲染 Markdown——标题就是标题,表格就是表格,标注块带着它们的颜色,数学公式就是数学公式。在访达中选中文件,按空格键,读完,再按一次空格键。它是免费的,随应用一起提供,没有任何需要配置的地方。

#安装应用,就有预览

没有单独的下载,没有 Homebrew 步骤,也不需要用 xattr -cr 绕过 Gatekeeper。MD Flow 通过 Mac App Store 发布;预览扩展是应用的一部分,安装应用时 macOS 就会注册它。

如果刚安装完,访达显示的仍是旧的预览,请先打开一次应用——macOS 会在首次启动时注册扩展。扩展也可以在「系统设置」的「登录项与扩展」中开启或关闭,如果你之前关掉过 Markdown 预览器,可以在那里找到它。

#它能渲染什么

和应用使用同一个渲染器,所以你按空格键看到的,就是正式打开文件时看到的样子:

  • 标题、段落和列表,配以真正适合阅读的排版
  • 表格、任务列表和语法高亮的代码块
  • Obsidian 风格的标注块(> [!note]、> [!warning]……)
  • KaTeX 数学公式,行内和独立公式都支持
  • YAML frontmatter 显示为整洁的信息头,而不是一堆横线

#它刻意不做的事

预览扩展不是应用的缩小版,假装它是,正是这类东西最后变得又慢又容易出错的原因。它有三个限制:

  • Mermaid 图表会退回为高亮显示的代码。 Mermaid 库大约有 2.5MB,会占掉扩展的大部分体积;而一个要解析这么多 JavaScript 的预览,会因为太慢而被 macOS 终止。在 MD Flow 中打开文件,图表就会渲染出来。
  • Wikilink 保持为文本。 解析 [[Another Note]] 需要遍历整个文件夹,而预览扩展拿到的只是一个文件,而不是它旁边的文件。
  • 本地图片尽力显示。 原因相同——扩展只被授权访问它被要求预览的那个文件,所以同目录下的图片可能读不到。这时它会留出空白,而不是让整个预览失败。在已连接文件夹的应用里,图片会正常加载。

#然后,还有整个文件夹

空格键适合看一个文件。当你手上实际是一个装着三十个文件的文件夹——一个文档目录树、一个 Obsidian 知识库(vault)、一个你的 AI 助手写入文件的目录——按三十次空格键可算不上浏览。这正是应用的用处:文件夹树旁边是渲染后的预览,还有搜索、最近文件和目录。请见浏览 Markdown 文件夹。

MD Flow 在 App Store 上免费提供,支持 Mac、iPhone 和 iPad。Pro 是一次性解锁(美国区 $7.99)——不限数量的文件夹、搜索文档内容、邮件草稿和 PDF 导出——永远不是订阅。

在 App Store 下载