MuM

什么是 MuM？

MuM 是一款面向阅读的 Markdown 引擎，基于手工编写的 AppKit 排版系统构建，而不是嵌入式 Web 引擎。它专为跨多个项目阅读和浏览文档而设计，同时提供文件管理、搜索、导出，以及对多种常见文档和媒体类型的支持。

通过 mum 命令行界面，无需打开窗口即可使用相同的渲染引擎。CLI 命令可以将 Markdown 渲染为 PNG 或 PDF，并以稳定的 JSON 输出大纲、搜索结果和检查结果，同时返回分类的退出码，因此适合脚本化和代理驱动的工作流。

MuM 能做什么？

多项目工作区

保持多个项目处于打开状态，并通过 `⌘1` 到 `⌘9` 在项目之间切换；项目为正在阅读的文件提供清晰的上下文。

面向阅读的导航

MuM 会记住阅读位置，并通过 `⌘F`、`⌘⇧O` 以及 `⌘[`/`⌘]` 提供文档查找、大纲导航和阅读历史控制。

跨项目搜索

使用 `⌘P` 按名称模糊查找文件，或使用 `⌘⇧F` 在所有项目中搜索文件名和内容；结果会在找到后持续流式显示。

支持 CJK 的排版与导出

行高、标点压缩和混合文字间距针对中文及混合语言文本进行了调校。当前文档可导出为长 PNG 或分页 PDF，文档中的分页提示也会保留在输出中。

广泛的阅读支持

阅读器支持代码高亮、CSV 和 TSV 表格、RTF、图像、PDF 以及 SRT/VTT 字幕。打开 Office 文件时，会显示一个引导页面，提示使用系统默认应用打开。

无窗口 CLI 渲染

`mum render` 使用相同的排版引擎，包括 CJK 间距、代码高亮和阅读主题，无需打开窗口即可生成 PNG 或 PDF 输出。`outline`、`search` 和 `check` 可输出稳定的 JSON，并返回 0 到 4 的退出码。

使用场景

“阅读一组项目文档”

将多个文件夹作为项目打开，通过键盘快捷键在项目之间切换；当不清楚文档位置时，使用跨项目的文件名或内容搜索。

“审阅较长的 Markdown 文件”

利用记住的阅读位置、文档内查找和大纲导航返回文档，并在各个章节之间移动，而不是把它当作一次性的文本预览。

“准备可视化文档输出”

将 Markdown 文档导出为连续图像形式的长 PNG，或导出为分页 PDF。源文档中的分页提示可以控制 PDF 的分页位置。

“自动化文档渲染”

在脚本或代理工作流中使用 CLI 渲染 Markdown，然后以 JSON 而不是面向人类的文字说明来处理大纲、搜索和检查结果。

“浏览混合项目资源”

在阅读 Markdown 的同时查看代码、表格、字幕、PDF、图像和 RTF 文件。对于 Office 文档，使用 MuM 的交接页面在默认应用中打开文件。

常见问题

MuM 是什么？

MuM 是一款面向阅读的 Markdown 引擎，配备基于 AppKit 的桌面阅读器和命令行渲染器，可输出 PNG 或 PDF，并执行结构化文档操作。

MuM 能处理单个 Markdown 文件吗？

可以。双击单个文件会打开单文件模式，侧边栏会收起以便阅读，同时不会将其所在文件夹添加为项目。

命令行界面可以做什么？

文档示例展示了 `mum render` 生成 PNG 输出，以及 `mum outline` 返回 JSON。`outline`、`search` 和 `check` 命令会输出稳定的 JSON，并返回分类的退出码。

MuM 同时支持导出图像和 PDF 吗？

支持。桌面端导出命令可以将当前文档生成长 PNG 或分页 PDF。CLI 也支持直接渲染为 PNG 或 PDF。

MuM 需要账户或会收集遥测数据吗？

产品网站称 MuM 无需账户，也不收集遥测数据。插件商店也不属于文档所述的产品体验。