浏览器 Pandoc vs Pandoc CLI
两者运行同一个 Pandoc 引擎——文档转换的黄金标准,已维护二十年。差异在于运行位置和可用能力。
本站通过 WebAssembly 在浏览器内运行 Pandoc。免安装、免服务器、免上传。CLI 版本安装在本机,解锁 CSL 引文处理、Lua 过滤器和 Shell 脚本。
| 浏览器 Pandoc(本站) | Pandoc CLI | |
|---|---|---|
| 安装 | 无需——打开网页即用 | 需安装二进制(brew、apt、chocolatey 等) |
| 隐私 | 文件不离开本机 | 本地运行,同样隐私 |
| 保真度 | 同一 Pandoc 引擎——脚注、公式、引文、表格全保真 | 同一引擎——外加 CSL 引文处理、Lua 过滤器 |
| 批量 | 拖入文件夹 | 自行编写脚本(bash、PowerShell、Make) |
| 离线可用 | 支持(PWA,首次加载后) | 支持(本地安装) |
| CSL 引文 | 不支持(浏览器沙箱限制) | 支持——引文文件 + CSL 样式 |
| Lua 过滤器 | 不支持 | 支持——自定义文档变换 |
| 价格 | 免费、无配额 | 免费开源 |
什么时候选浏览器 Pandoc
需要 Pandoc 的保真度但无法安装软件——受限办公电脑、学校 Chromebook、借用的机器。
隐私敏感内容:合同、未公开手稿、法律文档,绝不能经过任何服务器。
快速批量转换:拖入整个文件夹的 Word 或 ODT 文件,一次拿到 Markdown。
什么时候 CLI Pandoc 更合适
带 CSL 引文的学术写作:CLI 可解析 DOI、渲染参考文献、套用 CSL 样式(APA、Chicago、Vancouver)。
自动化:把 Pandoc 嵌入 Shell 脚本、Makefile、CI/CD。Lua 过滤器可做任意文档变换。
自定义输入/输出:CLI 支持浏览器 UI 未暴露的格式(ZimWiki、Muse、Jira 等)。
保真度对比
核心转换引擎完全相同——两者都用 Pandoc 的内部文档模型。脚注、引文、LaTeX 公式、嵌套表格、修订痕迹——无论哪个版本,转换结果同等保真。
CLI 的优势仅在外部工具:CSL 引文处理器需要引文数据库和样式文件(都需要文件系统访问),Lua 过滤器需要文件系统导入。