Pandoc 是一款用途非常广泛的文本格式转化工具,支持 Markdown, Latex 以及 HTML 等格式的互相转化,或者是输出成 PDF 文件等。我的博客就使用了 Pandoc 来替代 Hexo 自己的渲染引擎。Pandoc 的好处是其增加一些非常有用的 Markdown 扩展语法。重点是增加了对于公式的支持。Pandoc 的一些额外组件,例如 pandoc-citeproc 等,则进一步扩展了 Pandoc 的功能。这里我们介绍如何在 Ubuntu 环境下安装 pandoc。

访问 Pandoc 的官方文档,可以发现官方提供了面向 amd64 架构的预编译包。如果你的服务器的 CPU 是 x86 64 位操作系统,可以直接使用预编译文件。这里我下载的是最新的 2.11.4 版本。可以用下面的代码从 Github 下载 Release:

1
wget https://github.com/jgm/pandoc/releases/download/2.11.4/pandoc-2.11.4-linux-amd64.tar.gz

注1:遇到 tar.gz 这种文件解压就头疼话可以试试使用oh-my-zsh并启用extract这个插件,那么就可以使用x解压任何压缩文件。

注2:这里处理下载预编译的可执行文件,亦可选择下载.deb文件,然后使用 sudo dpkg -i $DEB_FILE 安装。

下载完成后解压,会得到一个bin文件夹和一个share文件夹。其中bin 文件夹里面存放着可执行文件,我们可以尝试运行:

1
2
3
4
5
6
7
8
9
10
$ cd pandoc-2.11.4/bin
$ ./pandoc -v

pandoc 2.11.4
Compiled with pandoc-types 1.22, texmath 0.12.1, skylighting 0.10.2,
citeproc 0.3.0.5, ipynb 0.1.0.1
User data directory: /home/lena/.local/share/pandoc or /home/lena/.pandoc
Copyright (C) 2006-2021 John MacFarlane. Web: https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.

将这个文件链接到 /usr/bin/ 目录下即可全局使用。

1
2
3
4
5
6
7
8
9
10
11
12
13
$ mv pandoc-2.11.4 path/to/store/
$ ln -s path/to/store/pandoc-2.11.4 path/to/store/pandoc
$ sudo ln -s path/to/store/pandoc/bin/pandoc /usr/bin/pandoc
$ cd somewhere/else
$ pandoc -v

pandoc 2.11.4
Compiled with pandoc-types 1.22, texmath 0.12.1, skylighting 0.10.2,
citeproc 0.3.0.5, ipynb 0.1.0.1
User data directory: /home/lena/.local/share/pandoc or /home/lena/.pandoc
Copyright (C) 2006-2021 John MacFarlane. Web: https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.

似乎使用 apt 也能安装 pandoc,但是版本比较老。

在 2.11.4 上 pandoc 已经内部集成了 citeproc,因此你不再需要手动安装 pandoc-citeproc。但是要注意一点,pandoc 使用 citeproc 的方式也发生了变化,原来的形式是 --filter pandoc-citeproc,现在应该修改为 --citeproc