[原创]使用Pandoc实现Markdown文件转PDF文件

Markdown写法简单明快，我十分喜欢，以至于我最近都想使用Markdown快速的进行测试说明书的写作，但是考虑到这文档是要进行交接的，一个.md的文件在内部传输还是有不便，于是就想到了能不能把Markdown转为PDF文件作为通用文件。

然后搜索后看到了这样的一篇文章如何把 Markdown 文件转化为 PDF，文中提到了很多方法，有使用.md->.html->.pdf的，也有.md->.word->.pdf，也有.md->.tex->.pdf的。最终考虑到之前曾经使用LaTex进行过文章写作，并且PC中还有着LaTex环境，决定使用Pandoc实现Markdown转PDF。

Pandoc介绍

Pandoc是一个用haskell编写的开源文本转换工具，小巧迅速且支持格式广泛，堪称文本转换应用的瑞士军刀。支持很多种输入输出，有关Pandoc可以在其官网进行详细了解。下载页面可以点此进入，在其中选择合适的版本即可（GitHub下载不多赘述）。

Markdown转PDF

全英文文档转换

在需要转换的文件路径下进行Shift+鼠标右键选择此处进入命令行，键入

1	pandoc input.md -o output.pdf

即可完成最简单的PDF文档。

中英文文档转换

在编写时，由于我们主体还是中文，那么若文档中存在中文字符，那么转换就会出问题。为了使的其支持中文，我们需要使用xelatex编译器（有关xelatex，还请大家自行搜索），下面直接放干货，可以一步操作到位的命令如下。

1	pandoc -N -s --toc --smart --latex-engine=xelatex -V CJKmainfont='黑体' -V mainfont='Times New Roman' -V geometry:margin=1in input.md -o output.pdf

大家可以自行编辑一些.md文档然后使用着条命令进行转换尝试。另外，Markdone转PDF的操作，也可以几个.md文件整合成一个PDF文件，其命令如下。

1	pandoc -N -s --toc --smart --latex-engine=xelatex -V CJKmainfont='黑体' -V mainfont='Times New Roman' -V geometry:margin=1in in1.md in2.md ... -o output.pdf

语法介绍

有兴趣的童鞋可以查看官方的HELP文档进行详细的了解，传送门：Pandoc Demos & README。

若是想重点了解下上文中所用到的一些参数及其意义可以看下面的一些说明。

1 2	--latex-engine=xelatex # 因为文档中有中文字符，使用XeLaTex引擎（必选项）

-N # 根据标题自动分配标号（可选项）

# H1标题#Title# --> 1/2/3/4/...

# H2标题##Title## --> 1.1/1.2/1.3/...

# H3标题###Title### --> 1.1.1/1.1.2/1.1.3/...

1	-toc # 给PDF文件加上书签功能

有关这些命令的详细说明都可在上面提到的README中进行查阅。比如命令-V，在上面操作中的作用就是设定中英文的显示字体，比如中文设定为黑体，英文设定为Times New Roman，你也可以自行设定合适的字体。

`-V` *KEY*[`=`*VAL*], `--variable=`*KEY*[`:`*VAL*]

: Set the template variable *KEY* to the value *VAL* when rendering the

document in standalone mode. This is generally only useful when the

`--template` option is used to specify a custom template, since

pandoc automatically sets the variables used in the default

templates. If no *VAL* is specified, the key will be given the

value `true`.

转换效果

本文也对一些.md文件进行了PDF文件转换，并附一些效果图于后供大家参考。其中使用的input.md文件使用了Cmd Markdown简明说明书的源文件，其网页渲染效果点此可见，可以与生成的PDF进行一个对比，看PDF生成的效果如何。本文使用的input.md也放出下载链接，

#Write