macOS 27.3及以上测试版已原生支持完整Markdown预览，含语法高亮与样式；否则需安装QLMarkdown扩展并配置Pygments引擎实现代码高亮渲染。
你的Mac空格键预览只能看纯文本.md文件，代码块全是白底黑字、标题和列表全无样式——这不是系统不行，是原生Quick Look还没启用完整Markdown渲染能力，得靠第三方扩展补足。
确认系统是否已原生支持（先省一步）
打开访达，找一个带代码块的 .md 文件（比如含
print("hello") 的文件），单击选中 → 按空格键。若看到语法高亮、标题分级、表格边框，说明你正运行 macOS 27.3 或更高测试版，【无需安装任何插件，系统已自带代码高亮与完整Markdown支持】。若仍显示井号、星号、反引号原样，继续下一步。
用QLMarkdown补足缺失能力
这是目前最稳定、轻量、适配广泛的方案，支持 GitHub Flavored Markdown 全套语法，包括代码高亮、数学公式、Mermaid流程图、表格渲染等。
方法一：Homebrew一键安装（推荐给终端常用者）
打开终端，逐行执行：brew install --cask qlmarkdown
安装完成后，【必须双击启动一次 Applications/QLMarkdown.app，否则系统不会注册扩展】。
方法二：手动安装（适合不碰命令行的用户）
去 QLMarkdown官方发布页 下载最新 .dmg → 双击挂载 → 将 QLMarkdown.app 拖入「应用程序」文件夹 → 右键图标 → 选择“打开”绕过“无法验证开发者”警告 → 双击运行该App一次。
验证是否生效：
在访达中选中任意 .md 文件 → 按空格键 → 观察代码块是否有背景色、关键字是否变色、是否出现可点击的链接。若仍为纯文本，执行 qlmanage -r 回车重建预览索引，再按 Option+Cmd+Esc 重启访达。
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索，适用于需要快速、高效搜索大量 Markdown 文章的场景。
让预览真正支持代码高亮（关键配置）
QLMarkdown 默认启用代码高亮，但依赖系统内置的 Pygments 引擎。macOS 13 及以上版本已预装，macOS 12 或更早需手动补装：
第一步：检查是否已就绪
终端执行 pygmentize -V，若返回版本号（如 2.16.1），跳过第二步；若提示 command not found，则需安装。
第二步：安装 Pygments（仅旧系统需要）
终端输入：pip3 install pygments。若提示 pip3 未找到，先运行 xcode-select --install 安装命令行工具，再重试。
第三步：强制刷新QLMarkdown识别
关闭所有访达窗口 → 终端执行 qlmanage -r → 重新打开访达，选中 .md 文件按空格。此时代码块应呈现带语言标识、语法着色的渲染效果。
