必须安装并激活 qlmarkdown 插件才能在 macos 访达中按空格键预览渲染后的 markdown 文件；推荐用 homebrew 执行 brew install --cask qlmarkdown 一键安装，安装后系统自动注册启用，验证方式为选中 .md 文件按空格键查看格式化效果。
要在 macOS 的访达（Finder）中选中 .md 文件后按空格键直接看到带标题层级、代码高亮、数学公式和任务列表的渲染效果，必须安装并正确激活 QLMarkdown 这个 Quick Look 扩展插件，否则系统只会显示原始文本。
用 Homebrew 一键安装（推荐开发者与命令行熟练者）
打开终端，粘贴执行以下命令：
brew install --cask qlmarkdown
安装完成后无需重启 Finder 或手动启用扩展，【系统会自动注册并启用插件】。验证方式：在访达中选中任意 .md 文件，直接按空格键——若看到格式化内容即成功。
若尚未安装 Homebrew，先运行官方脚本：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
手动拖拽安装（适合所有用户，尤其不熟悉终端者）
方法一：下载 → 拖入 → 强制打开 → 运行一次
1. 访问 QLMarkdown 官方发布页，下载最新 .dmg 文件
2. 双击打开 .dmg，将 QLMarkdown.app 拖入「应用程序」文件夹
3. 【右键点击 QLMarkdown.app → 选择“打开” → 点击“仍要打开”】（绕过 macOS 未签名应用拦截）
4. 双击运行该 App —— 界面可能一闪而退，这正是注册插件的正常表现
方法二：跳过图形界面，终端强制注册（当右键“打开”无效时备用）
终端执行：
xattr -rd com.apple.quarantine /Applications/QLMarkdown.app
再运行一次该 App 即可
启用与验证预览功能
第一步：刷新 Quick Look 缓存
打开终端，输入并回车：
qlmanage -r
第二步：重启 Finder 以加载新扩展
按 Option + Command + Esc → 在弹出窗口中选中 Finder → 点击“重新启动”
第三步：验证是否生效
在访达中找一个含 # 标题、```code 和 - [ ] 任务项的 .md 文件，单击选中 → 按空格键 → 若看到带缩进的标题、灰底代码块、可勾选方框，说明已就绪。
若仍只显示源码，请检查文件扩展名是否为 .md/.markdown/.qmd（QLMarkdown 不识别 .txt 或无扩展名文件）。
