103 Pandoc —— 一份稿子转成十种格式,一行命令就够了

一句话定位:Pandoc 是一款免费开源的通用文档转换器,Markdown、Word、HTML、EPUB、LaTeX、纯文本之间基本都能互转,命令行敲一行就出结果,不需要装 Office。

痛点:写完只是第一步,交出去才是麻烦

用 Markdown 写东西的人大概都遇到过这个循环:自己写着舒服,但甲方要 Word,公众号要 HTML,做电子书要 EPUB,投稿系统只收 PDF。手工复制粘贴进 Word,标题层级、列表缩进、代码块全得重排一遍,一篇五千字的稿子调格式能花掉半小时。

在线转换站也不是没试过。免费版限制 10MB、转三份就要登录、页面上广告比按钮大。更要紧的是文件要传到别人服务器上——合同、书稿、内部文档,多数人心里是不踏实的。

核心能力

  • 格式覆盖面广:输入支持 Markdown、docx、HTML、LaTeX、EPUB、ODT、rst、org 等几十种,输出同样几十种,两个方向都能走。
  • 单文件绿色运行:Windows 版就是一个 exe 加安装包,不依赖 Word 或 WPS,服务器上也能跑。
  • 模板套样式:--reference-doc 指定一个现成的 docx,导出的 Word 直接继承它的字体、字号、页边距和标题样式,交出去就是公司模板的样子。
  • 反向转换:docx 转 Markdown 是它的强项,旧稿子想搬进笔记软件,一条命令就能拆出干净的文本。
  • 批量与脚本化:配合批处理或 PowerShell 循环,一个文件夹几十份文档可以一次转完。
  • 模板变量与过滤器:写技术文档时能自动编号图表、生成目录、插入文献,靠的是 pandoc-crossref 这类过滤器。

实测体验

我拿一份 42 页、带三级标题和十几个表格的产品文档做测试:docx 转 Markdown 用了不到 3 秒,输出的标题层级、列表、粗体全部正确,表格转成了管道表格,只有两处合并单元格被拆成了普通行——这已经是这类工具里相当干净的结果。

再拿同一份 Markdown 导出 Word,套上事先做好的一份 reference-doc,字体、行距、页脚页码都跟着模板走,打开后基本不用再动。导出 HTML 是瞬时的,样式干净,没有一堆冗余的 span 标签。

PDF 是唯一需要额外准备的一环。Pandoc 本身不生成 PDF,它调用 LaTeX 引擎(如 MiKTeX、TinyTeX)或 HTML 转 PDF 的引擎来完成。第一次装 TinyTeX 大约 100MB,之后中文字体配置要花点时间,配好一次就一劳永逸。

适合谁

  • 长期用 Markdown 写作的人:博客、技术文档、书稿,写完直接出多种格式。
  • 需要按不同渠道交稿的编辑和作者:一份源文件,Word 给甲方、HTML 给网站、EPUB 给阅读器。
  • 要把旧文档迁移到新笔记系统的人:docx 批量转 Markdown,比手工复制快一个数量级。
  • 写论文的学生和研究者:Markdown 写正文,引用交给过滤器,最后出 PDF。

需要注意的地方

  • 它是命令行工具:没有图形界面,第一次用要查文档。常用参数就那么七八个,但确实有门槛。
  • PDF 输出要另装引擎:不装 LaTeX 就导不出 PDF,中文还要额外配字体,这是最容易劝退新手的一步。
  • 复杂排版会走样:Word 里的文本框、多栏、浮动图片、艺术字,转成 Markdown 基本留不住。它的定位是处理"结构化文本",不是还原像素级版式。
  • 版本差异要注意:不同大版本之间参数有调整,网上抄来的老命令可能报错,遇到问题先看当前版本的帮助。

小结

Pandoc 不是那种装完就能立刻上手的工具,它的价值在于把"格式转换"这件事从手工劳动变成一条可复用的命令。如果你一年只转两三次文档,它可能有点重;但如果你每周都要在几种格式之间来回倒腾,配好一次模板和参数之后,它省下的时间相当可观。免费、开源、无广告、不联网,这几个属性在文档工具里已经很难得了。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部