用途:在 macOS 上原生阅读 .md 文件,不依赖 Electron 或浏览器标签页,适合查看本地 Markdown 文档。
主要能力:文档大纲侧边栏、Mermaid 围栏代码块渲染图表、KaTeX 行内与显示数学公式、文档内搜索、Quick Look 扩展(Finder 空格预览离线渲染)、通过“打开方式”一键在常用编辑器中打开、以 Markdown 原文分享或复制。支持 .md/.markdown/.mdown(net.daringfireball.markdown)与 .txt(public.plain-text)。
使用方式:推荐从 Releases 页面下载已签名并公证的 DMG,拖入 /Applications。从源码构建: git clone git@github.com:pluk-inc/md-preview.app.git cd md-preview.app open md-preview.xcodeproj 然后构建并运行 md-preview scheme,首次构建由 SPM 解析 Sparkle 与 swift-markdown。要求 macOS 15+、含 Swift 6.0 的 Xcode,支持 Apple Silicon 或 Intel。
架构要点:以 swift-markdown(底层 cmark-gfm)解析文档,遍历语法树生成 HTML 并抽取标题构建目录,再载入 WKWebView;外部链接交由默认浏览器打开。Mermaid 与 KaTeX 使用打包的 JS 资源,离线可用。Quick Look 扩展为独立 .appex target,复用同一渲染管线。
限制:未提供 UI 自动化测试套件,UI 改动需手动冒烟测试;发布使用 Amore 完成签名、公证、DMG、S3 上传与 Sparkle appcast 更新。资料未提供收费、价格与平台之外的支持信息。常见问题可参考:Mermaid 空白时检查 baseURL 与打包资源;Quick Look 显示纯文本时可执行 qlmanage -r && qlmanage -r cache 重置缓存。