QLMarkdown
sbarex and contributors · macOS Quick Look 扩展,用于预览格式化的 Markdown,支持可配置主题及 Markdown 转 HTML 工具。
brew install --cask qlmarkdown- 近 30 天安装
- 2,783
- App榜第 123
- 近一年安装
- 3.5万
- 365 天累计
- 最新版本
- 1.5.7
- 下载大小
- 26MB
- zip
- 更新节奏
- 不定期
- 近 30 天 0 个版本
介绍
QLMarkdown 是 sbarex 开发的免费开源 macOS 应用,可安装用于格式化 Markdown 预览的 Quick Look 扩展。它适合希望在 Finder 中查看文档而不必打开完整编辑器的开发者、技术写作者和其他用户。此 Homebrew 软件包属于 sbarex 项目,与名称相似的旧项目不同。
功能
- 使用基于 cmark-gfm 的渲染,通过 macOS Quick Look 预览 Markdown。
- 配置浅色和深色主题、字体、源代码渲染及预览选项。
- 启用表格、任务列表、脚注、标题锚点及其他扩展。
- 高亮围栏代码,并可选择渲染 MathJax 公式或 Mermaid 图表。
- 预览受支持的 R Markdown、Quarto、MDX、API Blueprint 和 textbundle 文件。
- 使用内附命令行工具或实验性的快捷指令操作将 Markdown 转换为 HTML。
安装并启用扩展
使用 brew install --cask qlmarkdown 安装,或解压官方 QLMarkdown.zip,并将 QLMarkdown.app 放入 Applications。至少启动一次应用,以便 macOS 发现扩展,并让应用准备共享支持文件。在主应用中,点击打开 Quick Look 设置面板的按钮,并确认扩展已启用。在当前 macOS 版本中,文档所述路径为“系统设置”>“通用”>“登录项与扩展”>“Quick Look”;较旧系统的扩展设置位置有所不同。
在 Finder 中选中受支持的 Markdown 文件,然后按空格键进行预览。在配置应用中,按 Command-S 或选择“文件”>“保存设置”保存设置,也可启用自动保存。内嵌测试编辑器用于检查格式;开发者并未将此应用定位为独立的 Markdown 编辑器或通用文档查看器。R Markdown 预览不会执行 R 代码,MDX 预览也不会渲染 JSX。
如果其他应用也注册了 Markdown Quick Look 支持,其扩展或文件类型注册可能会优先处理。官方故障排除指南建议逐个测试其他 Quick Look 扩展,以找出冲突。cask本身未声明明确冲突的 cask或额外的 cask 依赖。Homebrew还提供内附的 qlmarkdown_cli 工具链接;该工具使用自己的设置,不与应用的 Quick Look 配置共享设置。
要求、权限与平台限制
当前 Homebrew cask 要求 macOS 12 Monterey 或更高版本,并注明支持 Intel 和 Apple Silicon。这是一款 macOS Quick Look 应用;目前未确认该项目提供官方 Windows 或 Linux 客户端。上游将预编译版本描述为已签名并经过公证。从源代码构建需要开发依赖项,但这些并非安装打包应用的额外要求。
Quick Look 扩展使用只读权限例外来解析本地预览图像;这并不意味着通常需要授予辅助功能或完全磁盘访问权限。本地图片嵌入和原始 HTML 是独立的渲染选项。原始 HTML 可能允许不安全内容,而默认设置会移除 HTML 标签和不安全链接;对于不可信文档,启用此选项前请先检查上游设置。MathJax 和 Mermaid 可使用网络托管的库或嵌入捆绑代码,因此 CDN 模式需要互联网连接。其他远程资源也取决于网络是否可用。
账户、费用与许可证
此应用是免费开源软件,附有 GNU GPL 版本 3 许可证文件。本地预览或 HTML 转换无需账户或订阅;捐赠为自愿选项。官方 1.5.7 ZIP 为 26,322,745 字节,这是下载文件大小,不代表安装后占用空间。未确定通用的内存或安装空间最低要求。
截图是官方带标签 README 中的 Mac Quick Look 预览示例,展示了渲染后的 Markdown,并非全新安装的 1.5.7 截图。
基本信息
- 系统要求
- macOS 12 起
- 芯片
- Apple 芯片 · Intel
- 自动更新
- 是
- 仓库
- 开源 · GPL-3.0 · 48 天前更新★3,782
- 开发者
- sbarex and contributors
- Homebrew
- 可以安装,应用会自行更新
- 其他名称
- sbarex QLMarkdown, qlmarkdown
- 主页
- github.com/sbarex/QLMarkdown
- 软件包标识符
- qlmarkdown
核查日期
1.5.7 更新内容
新版本 · OpenNavo 编辑
- 修复修复启用上标扩展时的脚注。
如何在 Mac 上安装 QLMarkdown
Homebrew 会把应用安装到“应用程序”文件夹。
不用 Homebrew 安装
直接下载 Homebrew 使用的同一个文件: 安装细节
卸载 QLMarkdown 与可选的数据清理
brew uninstall --cask qlmarkdown普通卸载会删除应用本身,设置和缓存会保留。
深度清理(可选)
brew uninstall --zap --cask qlmarkdown--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件,其中可能有其他应用共用的数据,删除后无法恢复;它也不保证没有任何残留。请先备份需要保留的数据;如要保留设置和缓存,请不要加 --zap。
关于 QLMarkdown 的常见问题
QLMarkdown 安全吗?
QLMarkdown 收录在 Homebrew 官方软件库中,没有被停用。自 2026 年 9 月起,Homebrew 会停用没有通过 macOS Gatekeeper 检查的应用。安装时,Homebrew 会用 SHA-256 校验值核对来自 github.com 的安装包。过去 30 天,它通过 Homebrew 安装了 2,783 次。
QLMarkdown 是开源软件吗?
QLMarkdown 的源代码公开在 GitHub 上(sbarex/QLMarkdown),使用 GPL-3.0 许可证。
怎样在 Mac 上彻底卸载 QLMarkdown?
运行 brew uninstall --cask qlmarkdown。它会退出应用。要连设置和缓存一起删除,运行 brew uninstall --zap --cask qlmarkdown。--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件,其中可能有其他应用共用的数据,删除后无法恢复;它也不保证没有任何残留。请先备份需要保留的数据;如要保留设置和缓存,请不要加 --zap。这会再删除 14 处文件和文件夹,包括 ~/。
QLMarkdown 支持 Apple 芯片(M1 及更新)的 Mac 吗?
Apple 芯片和 Intel 芯片的 Mac 都能用 Homebrew 安装,两者使用同一个安装包。需要 macOS 12 或更高版本。
QLMarkdown 的设置和数据保存在哪里?
设置保存在 ~/。数据保存在 ~/、~/和~/。这些位置来自 Homebrew 的清理清单。
QLMarkdown 的最新版本是多少?
最新版本是 1.5.7,Homebrew 收录于 2026年10月2日。QLMarkdown 会自动更新;想用 Homebrew 更新时,运行 brew upgrade --cask --greedy qlmarkdown。
安装 QLMarkdown 还会装上什么?
还会装上 1 个命令行工具:qlmarkdown_cli。
相似应用
- MonitorControl免费的 Mac 菜单栏工具,可控制支持的显示器亮度、对比度和音量,支持 DDC/CI、软件调暗及键盘快捷键。
- DockDoor免费的 macOS Dock 增强工具,支持实时窗口预览、单个窗口切换和可自定义的桌面控制。
- Shottr原生 Mac 屏幕截图捕获与编辑,支持标注、滚动截图、本地 OCR、像素测量和可选分享。
- OpenLogi本地优先的开源自定义工具,适用于受支持的 Logitech 鼠标、键盘、网络摄像头和 Litra 灯。