利用Pandoc将markdown文件转化为pdf

利用Pandoc将markdown文件转化为pdf

• 准备工做
  • 安装pandoc
  • 安装MiKTeX
• 将markdown文件转换为pdf

准备工做

安装pandoc

Windows下安装pandoc很容易，直接从pandoc官网上下载最新安装包安装便可。
Linux下的安装能够参考阳志平的博文¹。

安装MiKTeX

pandoc被称为格式转换的瑞士军刀²。执行程序文件只有20M左右大小，可是可以在几十种文件格式之间自如的转换，那固然是得依赖各类格式文件所须要库。转换为pdf就要用到MiKTeX，Windows下推荐使用CTeX完整版，对中文的支持很好，能够从CTeX官网下载完整套件。

将markdown文件转换为pdf

若是markdown文件中不包含中文字符，那么直接使用下面的命令就能够将markdown文件无缝转换为Latex支持的pdf文件。

pandoc infile.md -o outfile.pdf

若是markdown文件中包含中文字字符，那么上段命令就没法直接转换，可能会报如下错误：

! Package inputenc Error: Unicode char \u8:鍒?not set up for use with LaTex.
pandoc: Error producing PDF from Tex source.    
See the inputsnc package documentation for explanation.   
...

为了解决中文编译的问题，须要作如下的工做：

1. 将markdown文档的编码方式改成utf-8。比较简单的办法就是用记事本打开该文档，而后另存为时选择编码方式为utf-8。有可能当你改变编码方式后，文档中的中文全变成乱码了。为避免这种状况，能够在改变编码方式以前先复制文档的所有内容，而后在改变编码方式以后粘贴替换文档中的全木内容，这样就不会出现乱码了。

2. 编译pandoc默认的latex引擎是pdflatex，是不支持中文的，所以须要手动设置编译时所用的引擎为xelatex，编译命令改成：
   pandoc infile.md -o outfile.pdf --latex-engine=xelatex

3. 这时编译可能没有错误了，可是获得的pdf文档中可能全部的中文都没有了。这是字体的问题，由于编译时默认的字体时不支持中文的，因此咱们得手动设置中文字体。显然，所设的字体应该为系统中已装的字体，且字体的名字不能写错。有一个办法能够的到系统中所安装的全部字体名（见博文），即在控制台中输入命令：fc-list >> C:\fonts.txt。这样，扫到的字体信息就所有被导入到C盘根目录下的fonts.txt文件中了。这里咱们选择宋体，字体名称为“SimSun”，因而编译命令改成：
   pandoc infile.md -o outfile.pdf --latex-engine=xelatex -V mainfont="SimSun"
   注意：命令中的``V’’是大写
   这里字体名也能够不加双引号，可是若是字体名比较复杂（如包含空格）时，不加双引号就可能出错。

4. 好了，中文字符应该可以显示了，可是你可能会发现不少文字已经超出了文档的边界没法显示了，这是由于pandoc对中文的支持不太好，不能自动换行。可是这并不表示pandoc就真的没法完美处理中文文档了，由于技术界那些追求完美的极客们为咱们提供了无限的可能。这篇博文介绍了pandoc中文pdf转换攻略³，解决方案是使用网友编辑好的latex模板来生成pdf，这里用到的是tzengyuxio提供的pm-template.latex⁴。 下载模板后将其中的LiHei Pro字体替换成系统中安装有的中文字体便可，而后编译命令改成：
   pandoc infile.md -o outfile.pdf --latex-engine=xelatex -template=pm-template.latex
   注意：若是安装的MiKTeX（我用的是CTex）宏包不全，编译可能会出问题，如找不到exp13.sty等，所以推荐安装完整版的MiKTex。
   固然，你也可使用本身定义的模板来生成tex和pdf文件。首先使用命令 pandoc -D latex > my.latex 生成一个默认的模板，在对这个模板进行修改，如字体、自动换行等。

---

1. Markdown写做进阶：Pandoc入门浅谈: http://www.yangzhiping.com/tech/pandoc.html↩

2. 黑魔法利器pandoc: http://yanping.me/cn/blog/2012/03/13/pandoc/↩

3. pandoc中文pdf转换攻略：http://afoo.me/2013-07-10-how-to-transform-chinese-pdf-with-pandoc.html↩

4. pm-template GitHub: https://github.com/tzengyuxio/pages/tree/gh-pages/pandoc↩