Pandoc User’s Guide
John MacFarlane
August 22, 2022
1
Synopsis
2
Description
2.1
Using pandoc
2.2
Specifying formats
2.3
Character encoding
2.4
Creating a PDF
2.5
Reading from the Web
3
Options
3.1
General options
3.2
Reader options
3.3
General writer options
3.4
Options affecting specific writers
3.5
Citation rendering
3.6
Math rendering in HTML
3.7
Options for wrapper scripts
4
Exit codes
5
Defaults files
5.1
General options
5.2
Reader options
5.3
General writer options
5.4
Options affecting specific writers
5.5
Citation rendering
5.6
Math rendering in HTML
5.7
Options for wrapper scripts
6
Templates
6.1
Template syntax
6.2
Variables
7
Extensions
7.1
Typography
7.2
Headings and sections
7.3
Math Input
7.4
Raw HTML/TeX
7.5
Literate Haskell support
7.6
Other extensions
8
Pandoc’s Markdown
8.1
Philosophy
8.2
Paragraphs
8.3
Headings
8.4
Block quotations
8.5
Verbatim (code) blocks
8.6
Line blocks
8.7
Lists
8.8
Horizontal rules
8.9
Tables
8.10
Metadata blocks
8.11
Backslash escapes
8.12
Inline formatting
8.13
Math
8.14
Raw HTML
8.15
LaTeX macros
8.16
Links
8.17
Images
8.18
Divs and Spans
8.19
Footnotes
8.20
Citation syntax
8.21
Non-default extensions
8.22
Markdown variants
9
Citations
9.1
Specifying bibliographic data
9.2
Specifying a citation style
9.3
Citations in note styles
9.4
Raw content in a style
9.5
Placement of the bibliography
9.6
Including uncited items in the bibliography
9.7
Other relevant metadata fields
10
Slide shows
10.1
Structuring the slide show
10.2
Incremental lists
10.3
Inserting pauses
10.4
Styling the slides
10.5
Speaker notes
10.6
Columns
10.7
Frame attributes in beamer
10.8
Background in reveal.js, beamer, and pptx
11
EPUBs
11.1
EPUB Metadata
11.2
The
epub:type
attribute
11.3
Linked media
11.4
EPUB styling
12
Jupyter notebooks
13
Syntax highlighting
14
Custom Styles
14.1
Output
14.2
Input
15
Custom readers and writers
16
Reproducible builds
17
Running pandoc as a web server
18
Running pandoc as a Lua interpreter
19
A note on security
20
Authors