使用pandoc将markdown文件转为pdf

安装 pandoc

使用 conda 安装，命令如下：

`conda install pandoc`

如果安装失败，需要自己更新源，先查看下 conda 配置：

`conda config --list`

网上大部分文章都建议使用 conda config –add 更换清华镜像站，仔细下文章都是在2020年前的，最好是直接使用清华镜像站-Anaconda 镜像使用帮助 里配置。

打开 ~/.condarc，替换成以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
ssl_verify: false
channels:
  - defaults
show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  deepmodeling: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/

一定要将 ssl_verify 设置成 false，否则有可能安装不成功。

也可以直接复制官网的配置来替换，下图就是官网截图：

安装 MiKTex

pandoc 生成 pdf 是需要转成 latex 格式，再生成 pdf 的，这里需要安装 Latex。建议安装 MiKTex，它对中文支持比较全面，在MiKTex官网下载安装。

中文支持

在命令行使用：

`pandoc --pdf-engine=xelatex -V mainfont='Heiti SC' example.md -o example.pdf`

字体名称输入以下命令查看：

`fc-list :lang=zh`

也可以在 md 文件头部增加：

1
2
3
4
5
6
---
manfont: Heiti SC
title: {{title}}
author: {{author}}
date: {{date}}
---

然后使用命令：

`pandoc --pfd-engine=xelatex example.md -o example.pdf`

总结

还可以设置模板，使生成的 pdf 文件更美观，目前还是研究中。