Pandoc是一个用Haskell语言编写的开源文档转换工具，由John MacFarlane教授开发。它支持在数十种文档格式之间进行相互转换，包括Markdown、HTML、LaTeX、Word、PDF、EPUB等，被称为”文档转换的瑞士军刀”。

---

Pandoc 入门指南

什么是Pandoc？

Pandoc是一个强大的文档转换工具，能够将一种标记格式转换为另一种。比如你可以把Markdown文件转成PDF、Word文档或HTML网页，整个过程只需要一条命令。

安装Pandoc

Windows

从官网下载安装包：https://pandoc.org/installing.html

macOS

使用Homebrew安装：

brew install pandoc

Linux (Ubuntu/Debian)

sudo apt install pandoc

基本使用

假设你有一个example.md文件，想转换成PDF：

pandoc example.md -o example.pdf

常用转换示例：

• 转Word：pandoc input.md -o output.docx
• 转HTML：pandoc input.md -o output.html
• 转LaTeX：pandoc input.md -o output.tex

常用选项

• -s：生成完整文档（包含HTML头部等）
• --toc：生成目录
• -V：设置变量（如-V geometry:margin=1in设置PDF页边距）

一个完整示例

# 将Markdown转成带目录的PDF
pandoc report.md -s --toc -o report.pdf

# 转成带样式的HTML
pandoc article.md -s -c style.css -o article.html

进阶功能

Pandoc支持YAML元数据块、引用文献、数学公式（LaTeX语法）、表格、代码高亮等高级功能。你可以通过模板和过滤器进行深度定制。

学习资源

• 官方文档：https://pandoc.org
• GitHub仓库：https://github.com/jgm/pandoc
• 在线体验：https://pandoc.org/try

---

注意：以上Markdown内容可以直接保存为.md文件，用Pandoc转换后即可生成各种格式的文档。