# 在访达中预览 Markdown，渲染效果与 GitHub 一致

> 在访达中按下空格键，即可看到渲染后的 README 和其他 Markdown 文件：GitHub 风格 Markdown，支持表格、任务列表、Mermaid 图表、数学公式、脚注和提示框。

在 Markdown 文件上按下空格键，macOS 只显示纯文本。有了 Gander，快速查看会像 GitHub 那样显示它：标题、表格、任务列表、着色的代码、Mermaid 图表和数学公式，无需打开编辑器。

![快速查看中渲染后的 README.md：Nimbus Weather API 标题、一个绿色的 Tip 提示框，以及展示请求流程的 Mermaid 流程图。](https://ganderfinder.com/img/features/md-render-2x.webp)
![同一个 README 滚动到 Endpoints 表格和 Release checklist，其中有已勾选和未勾选的任务。](https://ganderfinder.com/img/features/md-scroll-2x.webp)

## 操作步骤

1. 从 Mac App Store 安装 Gander，并打开一次。
2. 在访达中选择一个 `.md` 或 `.markdown` 文件。
3. 按下空格键，渲染后的页面随即打开；**原文** 显示源文本，需要时还可显示行号。
4. 如需在链接可以打开的窗口中阅读，或者要导出，请按住 Control 键点按该文件，然后选取 **打开方式 › Gander**。

## GitHub 风格 Markdown 的全部功能

Gander 遵循 CommonMark 及 GitHub 的扩展语法，因此 README 在访达中的样子与在 GitHub 上一致。

- 表格、任务列表（`- [ ]` 和 `- [x]`）、删除线和自动链接
- 围栏代码块按语言着色，长行保持完整，每个代码块都带拷贝按钮
- GitHub 提示框（Note、Tip、Important、Warning 和 Caution）显示为彩色方框，引用带有 GitHub 式灰色竖条
- 使用 `$…$` 和 `$$…$$` 的数学公式、脚注和 `:emoji:` 短代码
- `mermaid` 代码块在页面中绘制为图表

## 浅色或深色，支持拷贝和缩略图

预览跟随 Mac 的浅色或深色外观。拷贝按钮会拷贝渲染后的文本并保留格式，可直接粘贴到“邮件”或“备忘录”；在“原文”中则拷贝源文本。在访达的图标视图和画廊视图中，Markdown 文件的缩略图显示其第一页。

## 快速查看做不到的事

快速查看预览无法载入图片，因此图片会显示为图片图标及其替代文本；Gander 窗口会显示存储在你 Mac 上的图片。在较新的 macOS 上，快速查看预览也无法打开链接，因此 Gander 会拷贝链接并给出提示。数学公式、脚注、提示框和表情符号都可以在 Gander 窗口中分别关闭。

## 常见问题

### 为什么快速查看把我的 Markdown 显示为纯文本？

macOS 没有为快速查看提供 Markdown 渲染器，因此会把 `.md` 文件显示为文本。Gander 这类快速查看扩展可以补上这一功能。安装后打开一次 Gander，并检查“系统设置” › “通用” › “登录项与扩展” › “快速查看”中是否已开启它。

### Gander 会将哪些文件渲染为 Markdown？

`.md`、`.markdown`、`.mdown` 和 `.markdn` 文件，无论位于何处：项目文件夹、“下载”、iCloud 云盘或外置驱动器。

### Gander 会更改或上传我的文件吗？

不会。它只读取文件来绘制预览，没有任何联网代码，App Store 隐私标签为“未收集数据”。

### 可以把 Markdown 文件转换为 PDF 或 Word 文稿吗？

可以，在同一个预览中即可完成：请参阅[Markdown 转 PDF 或 Word](https://ganderfinder.com/zh/markdown-to-pdf-word)。

## 更多指南

- [无需浏览器，在 Mac 上查看 Mermaid 图表](https://ganderfinder.com/zh/mermaid-viewer)
- [直接在访达中将 Markdown 转为 PDF 或 Word 文稿](https://ganderfinder.com/zh/markdown-to-pdf-word)
- [在 Mac 上直接从访达把 CSV 转为 Excel](https://ganderfinder.com/zh/csv-to-excel)
- [无需启动 Jupyter，在 Mac 上阅读 Jupyter 笔记本](https://ganderfinder.com/zh/jupyter-notebook-viewer)
- [访达中的快速 JSON 查看器，也支持 JSONC 和 JSON Lines](https://ganderfinder.com/zh/json-viewer)
- [在访达中查看 SQLite 数据库的内部](https://ganderfinder.com/zh/sqlite-viewer)
- [整齐排版任意 SQL 查询，而不改动文件](https://ganderfinder.com/zh/sql-formatter)
- [日志从最新一行打开，错误显示为红色](https://ganderfinder.com/zh/log-viewer)
- [检查 .env 文件，而不让机密出现在屏幕上](https://ganderfinder.com/zh/env-file-viewer)

Gander 可在 Mac App Store 免费下载，没有 App 内购买，无需订阅，无需账户，你预览的任何内容都不会离开你的 Mac。 https://apps.apple.com/app/id6817038818

---

- HTML 版本: https://ganderfinder.com/zh/markdown-quick-look
- English: https://ganderfinder.com/markdown-quick-look.md
- Español: https://ganderfinder.com/es/markdown-quick-look.md
- Deutsch: https://ganderfinder.com/de/markdown-quick-look.md
- Français: https://ganderfinder.com/fr/markdown-quick-look.md
- 日本語: https://ganderfinder.com/ja/markdown-quick-look.md
- Português (Brasil): https://ganderfinder.com/pt/markdown-quick-look.md
- 支持: https://ganderfinder.com/zh/support
- 隐私政策: https://ganderfinder.com/zh/privacy
- llms.txt: https://ganderfinder.com/llms.txt
- © 2026 65FN LLC