Pandoc简介

Pandoc是一款功能强大的文档转换工具，支持多种格式之间的相互转换。Markdown转换为Word是Pandoc的常见应用场景之一，通过自定义模板可以实现高度定制化的输出效果。

安装Pandoc

下载并安装Pandoc的最新版本。官方网站提供Windows、macOS和Linux的安装包。确保系统环境变量已配置，以便在命令行中直接调用Pandoc。

安装完成后，通过以下命令验证是否安装成功：

pandoc --version

基本转换命令

使用Pandoc将Markdown文件转换为Word文档的基础命令如下：

pandoc input.md -o output.docx

input.md是输入的Markdown文件，output.docx是输出的Word文档。此命令使用Pandoc的默认模板生成Word文件。

自定义模板的使用

Pandoc允许用户通过自定义模板控制Word文档的样式和布局。官方提供了默认的Word模板，用户可以根据需求修改或创建新的模板。

获取默认Word模板：

pandoc --print-default-template=reference.docx > custom-reference.docx

生成的custom-reference.docx文件可以作为自定义模板的基础。修改其中的样式（如标题、正文、列表等）后，保存为新的模板文件。

应用自定义模板：

pandoc input.md -o output.docx --reference-doc=custom-reference.docx

通过--reference-doc参数指定自定义模板文件，生成的Word文档将继承模板中的样式。

高级格式控制

Pandoc支持通过YAML元数据块或命令行参数进一步控制输出格式。例如，在Markdown文件头部添加以下元数据：

---
title: "文档标题"
author: "作者姓名"
date: "2023-10-01"
---

这些元数据会被自动插入到生成的Word文档中。

设置页面边距和纸张大小：

pandoc input.md -o output.docx -V geometry:margin=1in -V geometry:a4paper

通过-V参数传递变量，调整文档的页面布局。

处理复杂内容

表格、图片和数学公式在Markdown中可能需要特殊处理。Pandoc支持将Markdown表格转换为Word表格，图片路径需为相对或绝对路径。

数学公式的处理：

$$ E = mc^2 $$

Pandoc默认将LaTeX数学公式转换为Word的公式对象，确保输出文档中公式显示正确。

批量转换与自动化

对于多个Markdown文件的批量转换，可以编写脚本实现自动化。例如，在Linux或macOS中使用Bash脚本：

for file in *.md; do
    pandoc "$file" -o "${file%.md}.docx"
done

常见问题解决

若生成的Word文档样式不符合预期，检查模板文件中的样式定义是否正确。图片无法显示时，确认路径是否正确或尝试使用绝对路径。

中文乱码问题通常由编码引起，确保Markdown文件保存为UTF-8编码，并在命令中指定编码：

pandoc input.md -o output.docx --from markdown+emoji --to docx --standalone

性能优化

对于大型文档，转换过程可能较慢。禁用不必要的扩展或过滤内容可以提高速度：

pandoc input.md -o output.docx --no-highlight

--no-highlight参数禁用语法高亮，减少处理时间。

通过以上方法和技巧，可以高效地使用Pandoc将Markdown文档转换为符合需求的Word文件。