FluxMarkdown：macOS 快速预览工具

项目简介

FluxMarkdown 是一个 macOS Finder QuickLook 扩展，让你在 Finder 中选中 Markdown 文件后按 Space 空格键，就能直接看到排版精美的预览，无需打开编辑器。渲染使用内置的本地资源，并支持 Mermaid 图表、KaTeX 数学公式、GFM 语法、目录面板与图表展示。

主要功能

• Mermaid 图表：架构图、流程图、时序图等
• KaTeX 数学公式：行内与块级表达式
• GFM 支持：表格、任务列表、删除线、GitHub Alerts
• 代码高亮：支持 40 多种语言
• 图表渲染：Vega、Vega-Lite 与 Graphviz（DOT）
• TOC 面板：可交互目录，并跟踪当前章节
• YAML 元数据：自动解析 frontmatter 并显示为表格
• 导出：PDF（Cmd+Shift+P）与 HTML（Cmd+Shift+E）
• 缩放与平移：Cmd + + / - / 0、Cmd + 滚轮、触控板捏合
• 位置记忆：记住滚动位置与最近查看的文件
• 主题：浅色、深色、跟随系统
• 文件格式：支持 .md、.mdx、.rmd、.qmd、.mdoc、.mdc、.mmd、.livemd、.mkd、.mkdn、.mkdown、.mdwn、.mdown、.markdown，以及只读的 .tsv 表格预览

安装与使用

推荐使用 Homebrew 安装：

brew install --cask xykong/tap/flux-markdown

如果 Homebrew 提示 xykong/tap 不受信任，可只信任该 cask：

brew trust --cask xykong/tap/flux-markdown

也可以手动安装：从 Releases 下载最新的 FluxMarkdown.dmg，打开后将 FluxMarkdown.app 拖入 Applications。

安装后在 Finder 中选中 Markdown 文件按空格即可预览。常用快捷键：

快捷键	功能
Space	打开 QuickLook 预览
Cmd + + / - / 0	放大 / 缩小 / 重置
Cmd + Shift + E	导出为 HTML
Cmd + Shift + P	导出为 PDF
Cmd + ,	打开设置

设置窗口（Cmd+,）可调整外观主题、Mermaid / KaTeX / Emoji 开关、基础字号与代码高亮主题。

注意事项

• 渲染使用内置本地资源；应用会检查更新，并默认发送匿名使用统计，可在设置中关闭 Share Usage Statistics（应用与 Quick Look 分别设置）。统计不包含文档名称、路径或内容。
• 若提示「应用已损坏」或「未识别的开发者」，可在终端执行：xattr -cr "/Applications/FluxMarkdown.app"
• 若 QuickLook 未显示更新，可重置缓存：qlmanage -r
• 预览不工作时，确认应用位于 /Applications/，可尝试 killall Finder，或用 pluginkit -m -v 检查 QuickLook 扩展是否启用。
• .tsv 表格预览为只读查看器，最多显示 500 KiB、1,000 行、100 列、20,000 个单元格，不支持带引号的多行字段与非 UTF-8 编码。
• 项目采用 GPL-3.0 与商业许可双授权，闭源或专有产品使用需商业许可。

---

本作品整理自 GitHub 开源项目 xykong/flux-markdown，原作者 @xykong，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。