Pandoc：安装与配置全攻略

简介

Pandoc 是一款开源的格式转换软件，最开始的时候被作者用来生成讲义和课件。基本上这个软件能够实现大家日常所用到的绝大部分文件格式之间的相互转换。接下来主要介绍的是该软件在linux系统下的安装与使用(Windows安装很简单，使用的话和linux下没有太大的区别，都是在命令行模式下运行)。顺带提一下，Anaconda里面其实集成了这个工具，所以装了Anaconda的朋友可以直接使用，不用安装。

安装

安装不难，不需要额外编译，类似于那种解压即用的小工具。根据官网的文档下载并安装即可。我下载的  的压缩包，根据网站上说明，使用下述代码进行安装：

 tar xvzf $TGZ --strip-components 1 -C $DEST # $TGZ为安装包, $DEST为安装路径  vi ~/.bashrc # 修改个人环境方便调用pandoc  alias pandoc="$DEST/bin/pandoc" # .bashrc中添加的内容, $DEST为安装路径  source ~/.bashrc # 更新  pandoc -v # 检查是否成功安装

使用

使用也不难，基本上看一下help文档，或者官网指南就OK，觉得麻烦也可以上网搜两篇指南看看。这一篇还不错（https://www.jianshu.com/p/6ba04f669d0b）。

问题

我在使用过程会遇到过一些问题，在此记录说明一下以为参考。

Markdown => HTML

 pandoc --standalone --self-contained QA.md -o target.html -c software/pandoc/css/my.css --metadata pagetitle="..." # code

是指定你想要的HTML格式，作者在GitHub上有提供一些，网页上搜索一下也有不少很好看的模板。当然如果觉得原始版也挺好的话那就可以不设置这个参数；

这个参数我也不知道是什么意思，只是如果不设置这个参数会报warning(但不影响结果)，我就根据提示随便设置了一下。

如果目标格式是“HTML”，那么可得到如下效果：在转换得到目标HTML文件的过程中，会将依赖的“脚本，CSS，图片，视频”等文件的内容内嵌到目标HTML文件中。简单地说就是如果你不设置这个参数你会发现结果可能还是和丑丑的原版本css一样；

为目标格式文件增加合适的“header”和“footer”。如果目标格式是“HTML”，那么通过该选项可解决“由于未设置合适的字符编码，而导致的乱码问题。实际上我尝试过去掉这个参数，并没有乱码。当然这个还是设置一下以防万一。

Markdown => PDF

Pandoc本身是无法直接将文件转成PDF的，需要LaTeX的支持。如果想要知道pandoc支持哪些输出格式可以使用 命令查看。为了实现这个功能我们需要安装LaTeX(TeX Live版本)。

下载链接（http://www.tug.org/texlive/acquire-netinstall.html）可以在官网上找到，该下载链接中提供了不同系统对应的安装包，下载对应的安装包然后根据官网（http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-160003.1.1）提供的命令安装即可。

 tar -xzf install-tl-unx.tar.gz # 解压文件  cd install-tl-20190227 #进入解压路径  perl install-tl # 运行安装程序

安装时会默认安装full，大概需要5G硬存，我尝试了一下 按键进入安装模式选项，选择 安装基础模块，大概需要186MB硬存(小了好多，但是不建议，因为你之后会发现你会缺很多东西)，输入 键进入主菜单；

继续阅读屏幕输出信息，你会发现程序提示你没有权限(因为我真的没有对程序默认的安装文件夹进行修改的权限)，你可以选择 进入安装文件夹设置选项，然后选择 确认修改，在命令处输入路径(你可以选择粘贴，一次成功，因为你没法按 键删除错误的输入)；

返回主目录后输入 按钮进行安装 (如果是全模式安装，时间会很漫长，估计1-3h; 基础模块安装的话不到10分钟)。安装的时候会自动给你配置到个人环境变量。参考这篇文章（https://www.jianshu.com/p/dcc2f95cc086）可以解决很多后续的问题。

因为安装包过大并且考虑到以后只会用到其中极少的一部分功能，因而放弃了对TeX Live的安装，使用其他方式实现Markdown=>PDF的转换

markdown to pdf

 wkhtmltopdf --header-spacing 5 --margin-top 2cm --footer-right '[page]/[toPage]' --footer-spacing 5 --margin-bottom 2cm -t -s A4 $html $pdf # 比较好的页面效果

表示待转换格式的HTML文件， 表示转换后的pdf文件。