Pandoc安装与基本使用方法详述

01 Pandoc简介

Pandoc是一款功能极其强大的格式转换工具，涵盖格式广泛且转换效果好，
常用的 docx、md、tex、html 等格式都可以利用其进行相互转换。

02 Pandoc安装

1. Pandoc官网下载安装 ：
   Pandoc官网下载
2. 使用conda安装，conda安装方法详见：
   conda安装方法
   conda安装完成后，启动Anaconda prompt，输入以下命令安装Pandoc：

conda install Pandoc

然后输入以下命令安装 Pandoc-xnos，用于处理公式、图表等引用：

pip  install pandoc-xnos

03 使用方法

3.0 转换主体命令

若希望将 .xx 格式文档转化为 .yy 格式，在待转换文档 “test.xx” 所在路径下启动cmd，输入命令：

pandoc -i test.xx -o test.yy

其中，-i 为 input （输入）， -o 为 output （输出）；
输入 -i 可以忽略不写，直接输入以下命令即可实现转换 ：

pandoc  test.xx -o test.yy

3.1 markdown转换docx

3.1.1 直接转换

直接使用上述命令转换即可，输入：

pandoc test.md -o test.docx

3.1.2 自定义样式转换

新建docx文档作为参考文档，自定义各级标题、正文等所需样式，这里命名为“reference.docx”，输入以下命令：

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

转换后的docx将与参考文档 “reference.docx” 文档样式相同。

3.2 markdown转换pdf

通常情况下markdown编辑器配合插件都可以直接导出pdf格式文档，这里讲解如何使用Pandoc进行转换。
默认情况下，pandoc使用Latex生成pdf，所以需要安装Latex引擎，这里推荐TexLive。
Texlive官方网站下载
Texlive镜像网站下载（下载速度较快，推荐使用）
选择 texlive.iso(≈4G) 下载，而后安装。
若直接使用命令 pandoc test.md -o test.pdf 会报错：

提示我们添加xelatex作为排版引擎，并设置中文字体。
所以添加命令：

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

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

04 参考

Pandoc官方使用手册