在 macOS 中让“访达”空格预览 Markdown 文件需安装 QLMarkdown 插件：推荐用 Homebrew 执行 brew install --cask qlmarkdown，或手动下载安装 QLMarkdown.app 并首次右键打开激活；安装后选中 .md 文件按空格即可预览格式化内容，失败时可重启 Finder 或执行 qlmanage -r 重建索引。

在 macOS 中让“访达”（Finder）直接空格预览 Markdown 文件，核心是安装并启用 Quick Look 插件 QLMarkdown。它不依赖第三方编辑器或浏览器，系统级集成，轻量高效。

用 Homebrew 一键安装（推荐）

适合习惯终端操作、追求自动化部署的用户：

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

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

适用于不使用 Homebrew 的普通用户：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

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

验证是否生效

安装后立即测试，确认功能就绪：

• 在访达中找到任意一个 .md 或 .markdown 文件
• 选中该文件，按键盘空格键
• 若弹出窗口显示带标题、列表、代码块等格式化效果的内容，说明已成功
• 如仅显示原始文本，重启 Finder：按 Option + Command + Esc → 选中“访达” → “重新启动”

常见问题处理

预览异常时可优先检查这几项：

• macOS 版本需为 10.12（Sierra）或更新；旧系统可能不兼容
• 确保文件扩展名严格为 .md 或 .markdown（大小写敏感）
• 部分安全策略可能禁用第三方 Quick Look 插件，可在“系统设置 > 隐私与安全性 > 完全磁盘访问”中检查是否允许 qlmanage
• 若仍无效，尝试重建 Quick Look 索引：qlmanage -r（终端执行）