使用 pandoc 进行文档转换（markdown转word）

Posted 2022-04-02 catoop

pandoc 是一个神奇的转换工具（详见官网），它支持各种文档格式之间的转换。本文针对如何使用 pandoc 转换 markdown 为 docx 进行说明。

pandoc 下载

安装 pandoc
以 CentOS 为例，其他操作系统详见官网安装说明。

1、进入页面 https://github.com/jgm/pandoc/releases
2、下载 pandoc-2.17.1.1-linux-amd64.tar.gz
3、解压缩后bin目录中的 pandoc 即为可以直接使用的二进制文件。

文件转换

1、基本转换命令

进入 pandoc 的 bin 目录，执行如下转换命令

./pandoc test.md -o test.docx

这样就生成了一个 test.docx 文档，速度还没很快的。

2、中文乱码确实字体处理

中文乱码问题，大多与字体有关，解决方案详见文章 《Linux 系统字体安装》

3、按照模板格式转换

如果你希望转换后的 word 的标题、表格、内容字体等都按照预置的配置进行，则可以通过参数指定模板来进行转换，具体步骤如下：

a) 先导出默认模板

./pandoc -o custom-reference.docx --print-default-data-file reference.docx

b) 下载模板修改模板

下载（略）
修改模板你可以在模板上直接修改即可，更多可以修改的内容详见《官方文档手册》中的 --reference-doc 段落。

c) 基于修改后的模板进行文档转换

./pandoc --reference-doc=custom-reference.docx test.md -o test.docx

---

（END）