Pandoc安装与使用总结
- 1. Pandoc的安装
  - 1.1. Pandoc在Win10下的安装
    - 1.1.1. Pandoc安装方式
    - 1.1.2. 检查Pandoc是否安装以及安装版本
- 2. Pandoc的基本使用方法
  - 2.1. Pandoc转换主体命令格式
  - 2.2. Markdown转Word文档
    - 2.2.1. md转docx默认格式直接转换
    - 2.2.2. md转docx自定义样式转换
  - 2.3. Markdown转换PDF
- 3. 参考

Pandoc安装与使用总结

1. Pandoc的安装

1.1. Pandoc在Win10下的安装

关于标记语言转换工具Pandoc在Windows10安装和使用: https://blog.csdn.net/xtjatswc/article/details/109572110

1.1.1. Pandoc安装方式

由于Pandoc本身并不大，所以直接安装到C盘就可以。

（1）GitHub直接下载
Download the latest installer for Windows (64-bit)

备用地址：https://github.com/jgm/pandoc/releases/latest

（2）Chocolatey安装（推荐）
右键管理员模式打开Powershell，然后执行命令

choco install pandoc

1.1.2. 检查Pandoc是否安装以及安装版本

pandoc -v

pandoc 2.16.1
Compiled with pandoc-types 1.22.1, texmath 0.12.3.2, skylighting 0.12.1,
citeproc 0.6, ipynb 0.1.0.2
User data directory: C:\Users\hg_ac\AppData\Roaming\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.

2. Pandoc的基本使用方法

Pandoc安装与基本使用方法详述
: https://blog.csdn.net/qq_45224889/article/details/123463037

2.1. Pandoc转换主体命令格式

将.xx格式文档转换为.yy格式文档，在待转文档.xx所在路径下启动cmd或者powershell（在文件夹的导航栏输入cmd即可开启），输入

pandoc -i test.xx -o test.yy

其中，-i为input，-o为output。-i也可以忽略不写，直接输入一下命令。

pandoc test.xx -o test.yy

2.2. Markdown转Word文档

2.2.1. md转docx默认格式直接转换

pandoc test.md -o test.docx

2.2.2. md转docx自定义样式转换

新建r.docx作为参考文档，自定义各级标题、正文等所需格式，输入以下命令，转换后的.docx文件将与参考文档r.docx文档样式相同。

pandoc test.md -o test.docx --reference-docx=r.docx

2.3. Markdown转换PDF

通常Markdown编辑器配合插件都可以直接导出PDF格式文件，如Typora、VSCode等，这里讲解如何用Pandoc进行转换。默认情况下，Pandoc使用LaTex来生成PDF，所以需要安装LaTex引擎，这里推荐安装TexLive.

Texlive官方网站下载: https://www.tug.org/texlive/

Texlive2021镜像网站下载: https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/

镜像网站下载速度快于官网，选择texlive.iso(4.1G)下载，下载完成后即可安装。

如果直接使用pandoc test.md -o test.pdf，则会报错，因为文档中存在中文字符，需要格外定义，通过添加XeLaTex作为排版引擎，并设置中文字体来实现。

pandoc test.md -o test.pdf --pdf-engine=xelatex -V CJKmainfont="font"

font字体应该填写相应的英语标识，如：KaiTi（楷体）、SimSun（宋体）、FangSong（仿宋）、SimHei（黑体）等。

3. 参考

Pandoc官方使用手册: https://www.pandoc.org/MANUAL.html