如何在 Mac 上卸载 QLMarkdown
移除 QLMarkdown 前，先保留需要的主题和预览设置，官方卸载说明区分了应用与组支持文件，Markdown 文档本身分开处理，本页覆盖官网 Mac 压缩包中的应用和包内扩展。
先退出，再移除应用
先关闭正在使用的 Markdown 快速查看预览，退出 QLMarkdown，再按官方说明把 QLMarkdown.app 移进废纸篓，包内预览扩展随应用移走，Markdown 文档和需要的自定义资源先留下。
检查本机设置和残留
删除数据前，先把需要的主题、预览设置或自定义资源复制到这些目录之外备份。在访达按 Shift + Command + G，逐个打开下表的位置，退出 QLMarkdown 并关闭预览后，只把不再需要的文件或目录移到废纸篓，不存在的路径跳过。
| 位置 | 处理方式 |
|---|---|
~/Library/Group Containers/group.org.sbarex.qlmarkdown |
官方列出的支持目录，删除前先备份需要的主题和资源。 |
~/Library/Containers/org.sbarex.QLMarkdown |
主应用的沙盒数据，需要的预览设置先保留，想从头配置时再移除。 |
~/Library/Application Scripts/org.sbarex.QLMarkdown |
主应用的沙盒脚本目录，确认不再需要后移除。 |
~/Library/Containers/org.sbarex.QLMarkdown.QLExtension |
包内快速查看扩展的数据，关闭预览后检查。 |
~/Library/Application Scripts/org.sbarex.QLMarkdown.QLExtension |
快速查看扩展的沙盒脚本目录，关闭预览后检查。 |
~/Library/Application Scripts/group.org.sbarex.qlmarkdown |
应用组对应的脚本目录，确认没有其他应用继续使用这个组后再移除。 |
Homebrew cask列出了这些位置，还包括 Shortcut-Extension 数据、~/Library/Application Support/QLMarkdown、偏好设置和旧的 ~/Library/QuickLook/QLMarkdown.qlgenerator，只检查实际存在的应用专属条目，保留 QuickLook、Group Containers 上层目录和自己的 Markdown 文档。
检查卸载结果
pgrep -ifl QLMarkdown
command -v qlmarkdown_cli
ls -l /usr/local/bin/qlmarkdown_cli
readlink /usr/local/bin/qlmarkdown_cli
ls -ld /Applications/QLMarkdown.app "$HOME/Library/Group Containers/group.org.sbarex.qlmarkdown" "$HOME/Library/Containers/org.sbarex.QLMarkdown"
pgrep 没有输出只表示没有找到这个名称，不代表所有辅助进程都已退出，有输出时核对它的实际可执行文件路径，ls 提示路径不存在只说明这一处没有了，权限错误仍无法判断，留下的文件夹也可能是你要保留的数据。
command -v 显示当前 shell 找到的命令，不是正在运行的进程，没有路径只说明当前 PATH 找不到它，留下的命令可能属于另一种安装。
官方 CLI 说明允许手动创建 /usr/local/bin/qlmarkdown_cli 链接，ls -l 查看这个入口是否存在，readlink 显示它的目标。只有目标确实是 /Applications/QLMarkdown.app/Contents/Resources/qlmarkdown_cli，且这就是刚移除的那份应用时，才在访达按 Shift + Command + G 前往 /usr/local/bin，把 qlmarkdown_cli 这一个链接移到废纸篓，可能需要管理员授权。目标不同就先保留，它可能属于另一份安装，路径不存在则没有需要移除的入口。入口仍在但 readlink 没有输出或报错时，不能据此判断它就是这个链接，不要移除整个 bin 目录。
用 Homebrew 安装时
普通 cask 卸载会退出 QLMarkdown 并移除 cask 管理的 qlmarkdown_cli 命令，zap 涉及主应用和扩展的容器、脚本目录、列出的组目录、支持目录、偏好设置和旧生成器，需要的自定义资源先保留。
不运行 zap 时，用下面的命令卸载：
brew uninstall --cask qlmarkdown
Mole 会先核对整份删除清单，涉及未勾选、共享或无法确认的路径时不使用 --zap，已勾选的残留仍会清理。自己运行 brew uninstall --cask --zap qlmarkdown 会执行 Homebrew 的完整清单，不读取 Mole 的勾选状态。
Mole 会列出什么
Mole 默认勾选应用、它自己的缓存，以及主应用的 Containers 和 Application Scripts 目录，包内扩展的目录也可能默认勾选。上表的应用组目录属于这款应用时会勾选，移除前仍会核对有没有其他已安装应用在使用这个组，其他待确认的支持目录默认不勾选，需要保留的设置或资源先取消勾选。
这些是「卸载时一并移除数据和配置」关闭时的选择，打开后，符合条件的应用数据也可能勾选，确认前检查文件夹，需要保留的先取消勾选，共享数据仍需单独确认。
这次检查覆盖了什么
2026 年 9 月 25 日，从官网压缩包拷出的 QLMarkdown 1.5.5 用 Mole 开发构建测试，应用组的脚本目录首次留下，复测时已移到废纸篓，受保护的系统 WebKit 临时状态保留，没有核验自定义主题恢复或当前的 Shortcut 扩展。