直接安装 QLMarkdown 插件即可让 macOS 空格预览支持 Markdown 渲染，含标题、列表、链接、代码块、表格，可选 MathJax 与 Mermaid；推荐用 Homebrew 一键安装：brew install --cask qlmarkdown。

直接安装 qlmarkdown 插件即可让 macos 的空格预览（quick look）支持 markdown 语法渲染。它不依赖浏览器或编辑器，系统级生效，渲染效果包含标题、列表、链接、代码块、表格，甚至可选启用 mathjax 公式和 mermaid 图表。

推荐安装方式：Homebrew 一键部署

适合大多数用户，命令自动完成下载、注册与权限配置：

• 打开“终端”，执行：brew install --cask qlmarkdown
• 若尚未安装 Homebrew，先运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 安装完成后无需额外启用，插件会自动注册到 QuickLook 系统

手动安装（无命令行环境可用）

适用于不使用终端的普通用户：

Web fetch markdown of page

通过 jina.ai 将网页抓取为精简的 markdown，用于在需要获取 URL 并获取压缩的 markdown 内容以节省 token。触发词 l...

下载

• 前往 QLMarkdown 官方发布页 下载最新版 QLMarkdown.app
• 将应用拖入 /Applications 文件夹
• 首次运行需右键图标 → “打开”，绕过 macOS 对未签名应用的拦截
• 双击启动一次，确保 Quick Look 扩展被系统激活

验证与常见问题处理

安装后立即测试：

• 在访达中选中任意 .md 或 .markdown 文件，按空格键
• 若显示带层级标题、缩进列表、高亮代码块等内容，即已成功
• 若仅显示纯文本：尝试重启 Finder（Option + Command + Esc → 选“访达” → 重新启动）
• 仍无效时，在终端执行：qlmanage -r 强制刷新 QuickLook 缓存
• 注意扩展名必须为小写 .md（.MD 或 .Md 不识别）

进阶支持（可选）

QLMarkdown 还支持更多格式，开箱即用：

• .rmd（R Markdown）、.mdx（MDX）、.qmd（Quarto）
• 通过偏好设置可开启 MathJax（渲染 LaTeX 公式）和 Mermaid（绘制流程图、序列图等）
• 主题与字体大小可在插件偏好中调整，适配阅读习惯