Pandoc User’s Guide (April 7, 2024)

• 语言: 英语
• 格式: .pdf
• 来源: www.pandoc.org

摘要

Pandoc是一个Haskell库和命令行工具，用于在多种标记和文字处理格式间转换，包括Markdown、HTML、LaTeX和Word docx等。它支持扩展的Markdown语法，包含表格、定义列表、元数据块、脚注、引用和数学公式等功能。Pandoc采用模块化设计，分为读取器和写作器，允许用户自定义过滤器和扩展。转换过程中可能导致格式细节丢失，特别是在处理更复杂格式时。Pandoc还支持自定义模板和样式，用户可以通过指定模板或参考文档来控制输出格式。

AI总结

《Pandoc User’s Guide (April 7, 2024)》概述：

Pandoc 是一款用 Haskell 编写的图标格式转换库和命令行工具，支持多种标记语言和文字处理格式之间的转换，包括 Markdown、HTML、LaTeX 和 Word docx 等。其增强版的 Markdown 包括表格、定义列表、元数据块、脚注、引用、数学公式等扩展语法。

### 核心功能
1. **模块化设计**：
- Pandoc 由读取器（解析输入格式生成抽象语法树 AST）和写作器（将 AST 转换为目标格式）组成。
- 支持通过添加读取器或写作器扩展格式支持。
- 用户可通过自定义过滤器修改 AST。

2. **格式转换特点**：
- 转换时保留文档结构，但可能丢失部分格式细节（如页边距）。
- 从更表达丰富的格式转换时可能会导致信息丢失。

3. **基本使用方法**：
- 无输入文件时，从标准输入读取，输出默认到标准输出。
- 使用 `-o` 选项指定输出文件。
- 使用 `-s` 或 `--standalone` 生成完整的独立文档（如包含 `` 和 `` 的 HTML 文件）。

4. **模板系统**：
- 使用模板添加文档头部和尾部内容，可通过 `--template` 指定自定义模板。
- 模板变量可通过命令行或文档元数据设置。
- 支持对 EPUB、PDF、DOCX 等格式的模板定制。

5. **EPUB 和 DOCX 输出**：
- EPUB 输出需要样式表，可通过 `--css` 选项指定。
- DOCX 和 ODT 支持通过 `--reference-doc` 使用参考文档定制样式。

6. **Pandoc 的 Markdown 扩展**：
- 支持表格、定义列表、元数据块、脚注、引用、数学公式等语法。
- 与传统 Markdown 的主要区别在于支持多输出格式。

7. **其他功能**：
- 支持将媒体资源（如图片、音频、视频）嵌入到 EPUB 中，支持外部资源引用。
- 提供默认样式表（如 `epub.css`），可通过自定义 CSS 修改样式。

Pandoc 的设计目的是在保持 Markdown 语法的简洁性同时，扩展其功能以支持多种输出格式的高效转换。