Kali 安装 pandoc 及配置

版本的选择

Kali 源里的 pandoc 是 2.9 的版本，太老了，并且某些参数的使用需要 2.11 以上的版本，所以选择 conda 安装

# 安装 Anaconda
sudo wget https://repo.anaconda.com/archive/Anaconda3-2021.11-Linux-x86_64.sh
sudo chmod +x Anaconda3-2021.11-Linux-x86_64.sh
./Anaconda3-2021.11-Linux-x86_64.sh

conda search pandoc
# 搜索到 conda 中的 pandoc 最新版本为 2.12
conda install pandoc=2.12

其他需要安装的包

下面这些包可以很方便地使用 markdown 写论文/实验报告。

# 输出 pdf
sudo apt install texlive-full
# 参考文献引用
sudo apt install pandoc-citeproc
# 图表注释
sudo apt install python3-pip
pip3 install pandoc-fignos
pip3 install --upgrade pandoc-fignos
pip3 install pandoc-tablenos
pip3 install --upgrade pandoc-tablenos

在 conda 虚拟环境外使用 pandoc

使用 conda 安装的 pandoc 只能在虚拟环境中使用，而我个人不喜欢 conda 的虚拟环境。

# 添加环境变量
sudo gedit ~/.bashrc
# 创建别名，添加一行：
alias pandoc='~/anaconda3/bin/pandoc'
# 更新
source ~/.bashrc

示例

md 转 word：

# --reference-doc 可以指定 word 模板，pandoc会使用其中的格式，包括字体、页码、页眉页脚、页边距等。
# 注意 --citeproc 一定要放在 --filter 图/表交叉引用 的后面
pandoc --filter pandoc-fignos --filter pandoc-tablenos --citeproc --bibliography=ref.bib --csl=chinese-gb7714-2005-numeric.csl --reference-doc=reference.docx -M reference-section-title="参考文献" test.md -o test.docx

md 转 pdf：

可以配合这篇文章食用：Linux下pandoc的配置

效果其实不是很好，需要找一个好模板，eisvogel 是一个可用的模板。

模板中默认中文字体为 Noto Serif CJK JP，需要先下载放到 Kali 的字体目录/usr/share/fonts/truetype/

然后执行以下代码，执行完可能需要重启

mkfontdir
mkfontscale
fc-cache

转换代码

# --listings 生成代码块
pandoc --filter pandoc-fignos --filter pandoc-tablenos --citeproc --bibliography=ref.bib --csl=chinese-gb7714-2005-numeric.csl --template=eisvogel.tex --pdf-engine=xelatex -M reference-section-title="参考文献" test.md -o test.pdf --listings

不过仍然建议先转 word 改完了格式再转 pdf。