showmd icon

showmd

showmd 是一款免费的开源 macOS Quick Look 扩展,可在 Finder 中渲染 Markdown 文件而非显示原始文本。支持 YAML frontmatter、渲染/源代码切换、深色模式等 Markdown 功能。

showmd

概览

showmd 是一款原生 macOS Quick Look 扩展,用于在 Finder 中预览 Markdown 文件。与内置的预览 App 相比,它以渲染后的 Markdown 代替原始源文本,使 .md 文件更易阅读。

该预览支持 YAML frontmatter、渲染/源代码切换、深色模式、语法高亮、数学公式、Mermaid 图表、行内图片以及若干 Markdown 相关文件扩展名。网站说明它是开源、免费的,并且需要 macOS 26(Tahoe)或更高版本。

功能

原生 Quick Look 预览

作为 macOS Quick Look 扩展注册,因此你可以在 Finder 中按空格预览 Markdown 文件,使用系统预览流程,而不是打开编辑器。

Frontmatter 渲染

将 YAML frontmatter 渲染为可折叠的元数据表,默认折叠,这样文件元数据可以保留可见,同时不会占据整个预览。

渲染/源代码切换

可在渲染后的 Markdown 与原始源代码之间切换,并可从渲染视图将文件复制为 HTML。

完整的 Markdown 渲染

支持 GitHub Flavored Markdown,包括表格、任务列表、删除线、围栏代码块、提示框、脚注、自动链接等。

语法高亮

使用支持语言感知的语法高亮来渲染代码块,开箱即支持 190 多种语言。

丰富的预览内容

可处理行内和块级 LaTeX 数学公式、Mermaid 图表、相对图片,以及常见的 Markdown 相关文件扩展名,例如 .md、.markdown、.mdx、.mdc、.rmd 和 .qmd。

使用场景

  • 在 Finder 中浏览 Markdown 文件

    在 Finder 中以渲染后的布局预览 .md 文件,这样无需打开单独的编辑器就能快速浏览内容。

  • 更清晰地阅读说明文件

    查看 AI 提示文件,例如 AGENTS.md、CLAUDE.md 以及类似的基于 Markdown 的说明,并保留其格式而非原始文本。

  • 审阅结构化的 Markdown 内容

    检查依赖 frontmatter、图表或数学公式的文档,并在 Quick Look 中直接渲染这些元素。

  • 在渲染视图和源代码视图之间切换

    在需要验证格式或将文件复制为 HTML 时,对比渲染版本和原始源代码。

Pros and Cons

Pros

  • 无需打开编辑器即可在 Finder 中保持 Markdown 的可读性。
  • 将 YAML frontmatter 作为可折叠的元数据表显示。
  • 提供渲染/源代码切换和“复制为 HTML”操作。
  • 支持深色模式,并遵循 macOS 外观设置。
  • 覆盖了广泛的 Markdown 功能,包括 GFM、数学公式、Mermaid 和语法高亮。

Cons

  • 需要 macOS 26(Tahoe)或更高版本。
  • 源页面除了说明该产品免费且开源之外,没有提供详细的定价或许可证说明。
  • 部分功能细节只显示在首页,因此从现有来源来看,长期文档和支持范围并不完全清晰。

FAQ

如何在 Finder 的快速查看中启用 showmd?

下载 showmd,先打开一次,然后在“系统设置” → “隐私与安全性” → “扩展” → “快速查看”中启用它。首次启动时,macOS 可能会请求访问其他 App 中的数据,以便应用和扩展共享设置。

YAML frontmatter 会如何处理?

showmd 会解析 YAML frontmatter 区块,并将其渲染为一个可折叠的元数据表,默认处于折叠状态。源文档显示它支持普通值、带引号的字符串、数组以及多行折叠块。

我可以在渲染后的 Markdown 和源代码之间切换吗?

可以。每个预览都包含“渲染 / 源代码”切换,渲染视图还提供“复制为 HTML”选项。

showmd 支持深色模式吗?

可以。showmd 会自动跟随 macOS 的外观设置,并且其设置中可选择浅色、深色或自动。

Quick Facts

类别
开发者工具
平台
macOS
主要用途
用于 Markdown 文件的 Finder Quick Look 预览
源域名
showmd.yetanother.one
可用性
免费且开源
系统要求
macOS 26(Tahoe)或更高版本