Pandoc Cheatsheet - Document Conversion Command Reference

Pandoc 文档格式转换最常用的命令都在这里了，格式转换时对照查。

Dev Tools·38 commands·Last updated 2026-07-21

Back to Dev Tools

基础转换 8

pandoc input.md -o output.html⧉

Markdown 转 HTML

pandoc input.md -o output.pdf⧉

Markdown 转 PDF（需 LaTeX）

pandoc input.md -o output.docx⧉

Markdown 转 Word

pandoc input.html -o output.md⧉

HTML 转 Markdown

pandoc input.docx -o output.md⧉

Word 转 Markdown

pandoc input.md -o output.epub⧉

Markdown 转电子书

pandoc -f markdown -t html5 input.md -o output.html⧉

显式指定输入输出格式

pandoc input.md -o output.org⧉

Markdown 转 Org-mode

PDF 高级选项 5

pandoc input.md -o output.pdf --pdf-engine=xelatex⧉

使用 xelatex 引擎（支持中文）

pandoc input.md -o output.pdf -V mainfont="Noto Sans CJK SC"⧉

指定中文字体

pandoc input.md -o output.pdf --toc⧉

生成目录

pandoc input.md -o output.pdf --toc --toc-depth=3⧉

目录层级 3 级

pandoc input.md -o output.pdf -V geometry:margin=1in⧉

设置页边距

模板与样式 5

pandoc -s input.md -o output.html⧉

生成独立 HTML（含 head）

pandoc input.md --template=mytemplate.html -o output.html⧉

使用自定义模板

pandoc input.md --css=style.css --self-contained -o output.html⧉

内嵌 CSS 生成单文件

pandoc input.md -H header.html -o output.html⧉

在 head 中插入自定义内容

pandoc -o template.html --print-default-template html5⧉

输出默认模板

元数据与幻灯片 5

pandoc input.md -V title="标题" -V author="作者" -o output.pdf⧉

设置元数据

pandoc input.md -t beamer -o output.pdf⧉

Markdown 转 Beamer 幻灯片

pandoc input.md -t slidy -o output.html⧉

转 Slidy HTML 幻灯片

pandoc input.md -t revealjs -o output.html⧉

转 reveal.js 幻灯片

pandoc input.md -f markdown -t plain⧉

转纯文本（去格式）

引用文献与公式 Citations & Math 6

pandoc input.md --citeproc -o output.pdf⧉

启用引用文献处理

pandoc input.md --bibliography=refs.bib --citeproc -o output.pdf⧉

指定 BibTeX 文献库

pandoc input.md --csl=ieee.csl -o output.pdf⧉

指定引用格式（CSL 样式）

pandoc input.md --mathjax -o output.html⧉

用 MathJax 渲染数学公式

pandoc input.md --katex -o output.html⧉

用 KaTeX 渲染数学公式

pandoc --list-extensions markdown⧉

列出 Markdown 支持的扩展

常用参数 9

--highlight-style=tango⧉

代码高亮主题

--number-sections⧉

给标题加编号

--standalone / -s⧉

生成完整文档（含头尾）

--metadata-file=meta.yaml⧉

从 YAML 读取元数据

--filter=pandoc-filter⧉

使用自定义过滤器

-V key=value⧉

传递变量给模板

--wrap=auto⧉

自动换行（auto/preserve/none）

--columns=80⧉

设置换行列宽

--reference-doc=template.docx⧉

用 Word 参考文档控制样式

💡 Tips

中文 PDF 必须用 xelatex 引擎并指定中文字体，否则乱码。
Markdown 转 Word 后样式可能丢失，建议先转 HTML 再转 DOCX 保真度更高。
pandoc --list-output-formats 查看所有支持的输出格式。