如何将markdown转化为pdf

对于挂载在github上的md简历,使用时总要转成pdf,本文记录一下把markdown转为PDF时候的一些历程。

pandoc及下载和安装

pandoc官网（http://www.pandoc.org）

下载pandoc

• 官网下载链接：https://github.com/jgm/pandoc/releases/tag/2.2
• 根据自己的操作系统位数下载合适的msi安装包，我下载的是：pandoc-2.2-windows-x86_64.msi

尝试过的不合适的方案

下面涉及的转换方法可以参见pandoc的使用文档（http://www.pandoc.org/MANUAL.html），这里不再叙述细节。

• 直接使用pandoc把md转为PDF。问题：报错，原因是电脑没有安装Latex解析引擎。
• 装好了MiKTex这样一个Latex解析引擎之后，再转，又失败了，原因是不支持中文字体（md文件中有中文字体）。
• 指定字体为宋体后再转，虽然成功转为了PDF文件，但是文件的字体、行间距、排版等样式都比较丑陋，不满意。
• 在网上又搜了搜，再加上指定Latex模板文件转，虽然能够调整一些参数了，但一方面模板文件犹如天书般难懂，另一方面很多格式还是不能精细调整。
• 变换一下思路，采取迂回战术，按照md->HTML->PDF的路径转。于是先把md转为HTML，HTML的样式倒是挺美观，然后在浏览器中使用浏览器的打印功能把HTML转为PDF。然而还是存在文档格式不能精细调整的问题。
• 发现转HTML的时候可以指定css样式文件，在css样式文件中可以配置标题、正文、段落的精细格式。奈何这种方法和Latex模板文件的缺点类似，投入/产出比过高，遂放弃。

一个不太合适的方案

在网上搜的时候，发现有一个Python三方库叫pypandoc（文档：https://pypi.org/project/pypandoc/），核心方法叫pypandoc.convert_file，支持一大堆参数。还是考虑到投入/产出比，我只是想安静地转一下md到PDF，并不想开发一个很吊的文件转换工具，所以暂时没必要去研究这个三方库的API，以后有需要再研究吧。

最终采取的解决方案
最终转换到另一种思路来，依然采用迂回战术，不过是按照：md->docx->PDF，一试，发现这种方式很靠谱，主要是因为：一是md转为docx很简单，只需pandoc的一条命令就搞定，不需要额外装其他的软件；二是转为docx文档后，还可以在其中手动精细调整字体、字号、段落之类的格式，直到自己满意为止。最后用Word也可以完美地把docx转为PDF。

而且在生成的docx文档中手工调完精细格式之后，还可以把docx文档的格式模板导出成dot文档模板文件保存，后面再生成docx文档时不需要再一个个手工调格式了，只需把这个dot模板文件中的样式全部导入即可（怎么导入可以到网上搜）。

md转为docx文档的pandoc命令类似于这样：
pandoc text.md -o text.docx

这种方案最为优雅，遂采用之。
采纳别人的，自己用下