@@ -128,12 +128,9 @@ To do this, specify an output file with a `.pdf` extension, as before,
128128but add the `--pdf-engine` option or `-t context`, `-t html`, or `-t ms`
129129to the command line (`-t html` defaults to `--pdf-engine=wkhtmltopdf`).
130130
131−PDF output can be controlled using [variables for LaTeX] (if
132−LaTeX is used) and [variables for ConTeXt] (if ConTeXt is used).
133−When using an HTML/CSS-to-PDF-engine, `--css` affects the output.
134−If `wkhtmltopdf` is used, then the variables `margin-left`,
135−`margin-right`, `margin-top`, `margin-bottom`, `footer-html`,
136−`header-html` and `papersize` will affect the output.
131+PDF output uses [variables for LaTeX] (with a LaTeX engine);
132+[variables for ConTeXt] (with ConTeXt); or [variables for `wkhtmltopdf`]
133+(an HTML/CSS-to-PDF engine; `--css` also affects the output).
137134
138135To debug the PDF creation, it can be useful to look at the intermediate
139136representation: instead of `-o test.pdf`, use for example `-s -o test.tex`
@@ -1027,16 +1024,51 @@ Options affecting specific writers {.options}
10271024 custom-reference.docx`. Then open `custom-reference.docx`
10281025 in Word, modify the styles as you wish, and save the file.
10291026 For best results, do not make changes to this file other
1030− than modifying the styles used by pandoc: [paragraph]
1031− Normal, Body Text, First Paragraph, Compact, Title,
1032− Subtitle, Author, Date, Abstract, Bibliography, Heading 1,
1033− Heading 2, Heading 3, Heading 4, Heading 5, Heading 6,
1034− Heading 7, Heading 8, Heading 9, Block Text, Footnote Text,
1035− Definition Term, Definition, Caption, Table Caption,
1036− Image Caption, Figure, Captioned Figure, TOC Heading;
1037− [character] Default Paragraph Font, Body Text Char,
1038− Verbatim Char, Footnote Reference, Hyperlink; [table]
1039− Table.
1027+ than modifying the styles used by pandoc:
1028+
1029+ Paragraph styles:
1030+
1031+ - Normal
1032+ - Body Text
1033+ - First Paragraph
1034+ - Compact
1035+ - Title
1036+ - Subtitle
1037+ - Author
1038+ - Date
1039+ - Abstract
1040+ - Bibliography
1041+ - Heading 1
1042+ - Heading 2
1043+ - Heading 3
1044+ - Heading 4
1045+ - Heading 5
1046+ - Heading 6
1047+ - Heading 7
1048+ - Heading 8
1049+ - Heading 9
1050+ - Block Text
1051+ - Footnote Text
1052+ - Definition Term
1053+ - Definition
1054+ - Caption
1055+ - Table Caption
1056+ - Image Caption
1057+ - Figure
1058+ - Captioned Figure
1059+ - TOC Heading
1060+
1061+ Character styles:
1062+
1063+ - Default Paragraph Font
1064+ - Body Text Char
1065+ - Verbatim Char
1066+ - Footnote Reference
1067+ - Hyperlink
1068+
1069+ Table style:
1070+
1071+ - Table
10401072
10411073 ODT
10421074
@@ -1333,27 +1365,8 @@ pandoc will look for the key in the document's metadata – which can be set
13331365using either [YAML metadata blocks][Extension: `yaml_metadata_block`]
13341366or with the `--metadata` option.
13351367
1336−Variables set by pandoc
1337−-----------------------
1338−
1339−Some variables are set automatically by pandoc. These vary somewhat
1340−depending on the output format, but include the following:
1341−
1342−`sourcefile`, `outputfile`
1343−: source and destination filenames, as given on the command line.
1344− `sourcefile` can also be a list if input comes from multiple files, or empty
1345− if input is from stdin. You can use the following snippet in your template
1346− to distinguish them:
1347−
1348− $if(sourcefile)$
1349− $for(sourcefile)$
1350− $sourcefile$
1351− $endfor$
1352− $else$
1353− (stdin)
1354− $endif$
1355−
1356− Similarly, `outputfile` can be `-` if output goes to the terminal.
1368+Metadata variables
1369+------------------
13571370
13581371`title`, `author`, `date`
13591372: allow identification of basic aspects of the document. Included
@@ -1375,53 +1388,35 @@ depending on the output format, but include the following:
13751388
13761389`keywords`
13771390: list of keywords to be included in HTML, PDF, and AsciiDoc metadata;
1378− may be repeated as for `author`, above
1379−
1380−`header-includes`
1381−: contents specified by `-H/--include-in-header` (may have multiple
1382− values)
1383−
1384−`toc`
1385−: non-null value if `--toc/--table-of-contents` was specified
1386−
1387−`toc-title`
1388−: title of table of contents (works only with EPUB,
1389− opendocument, odt, docx, pptx, beamer, LaTeX)
1390−
1391−`include-before`
1392−: contents specified by `-B/--include-before-body` (may have
1393− multiple values)
1394−
1395−`include-after`
1396−: contents specified by `-A/--include-after-body` (may have
1397− multiple values)
1398−
1399−`body`
1400−: body of document
1401−
1402−`meta-json`
1403−: JSON representation of all of the document's metadata. Field
1404− values are transformed to the selected output format.
1391+ repeat as for `author`, above
14051392
14061393Language variables
14071394------------------
14081395
14091396`lang`
1410−: identifies the main language of the document,
1411− using a code according to [BCP 47] (e.g. `en` or `en-GB`).
1412− For some output formats, pandoc will convert it to an appropriate
1413− format stored in the additional variables `babel-lang`,
1414− `polyglossia-lang` (LaTeX) and `context-lang` (ConTeXt).
1415−
1416− Native pandoc Spans and Divs with the lang attribute
1417− (value in BCP 47) can be used to switch the language in
1418− that range. In LaTeX output, `babel-otherlangs` and
1419− `polyglossia-otherlangs` variables will be generated
1420− automatically based on the `lang` attributes of Spans
1421− and Divs in the document.
1397+: identifies the main language of the document using IETF language
1398+ tags (following the [BCP 47] standard), such as `en` or `en-GB`.
1399+ The [Language subtag lookup] tool can look up or verify these tags.
1400+ This affects most formats, and controls hyphenation in PDF output
1401+ when using LaTeX (through [`babel`] and [`polyglossia`]) or ConTeXt.
1402+
1403+ Use native pandoc [Divs and Spans] with the `lang` attribute to
1404+ switch the language:
1405+
1406+ ---
1407+ lang: en-GB
1408+ ...
1409+
1410+ Text in the main document language (British English).
14221411
1412+ ::: {lang=fr-CA}
1413+ > Cette citation est écrite en français canadien.
1414+ :::
1415+
1416+ More text in English. ['Zitat auf Deutsch.']{lang=de}
1417+
14231418`dir`
1424−: the base direction of the document, either `rtl` (right-to-left)
1419+: the base script direction, either `rtl` (right-to-left)
14251420 or `ltr` (left-to-right).
14261421
14271422 For bidirectional documents, native pandoc `span`s and `div`s
@@ -1436,22 +1431,19 @@ Language variables
14361431
14371432[BCP 47]: https://tools.ietf.org/html/bcp47
14381433[Unicode Bidirectional Algorithm]: http://www.w3.org/International/articles/inline-bidi-markup/uba-basics
1434+[Language subtag lookup]: https://r12a.github.io/app-subtags/
14391435
1440−Variables for slides
1441−--------------------
1442−
1443−Variables are available for [producing slide shows with pandoc],
1444−including all [reveal.js configuration options].
1436+Variables for HTML slides
1437+-------------------------
14451438
1446−`titlegraphic`
1447−: title graphic for Beamer documents
1439+These affect HTML output when [producing slide shows with pandoc].
1440+All [reveal.js configuration options] are available as variables.
14481441
1449−`logo`
1450−: logo for Beamer documents
1442+`revealjs-url`
1443+: base URL for reveal.js documents (defaults to `reveal.js`)
14511444
1452−`institute`
1453−: author affiliations in Beamer. Can be a
1454− list when there are multiple authors.
1445+`s5-url`
1446+: base URL for S5 documents (defaults to `s5/default`)
14551447
14561448`slidy-url`
14571449: base URL for Slidy documents (defaults to
@@ -1460,80 +1452,120 @@ including all [reveal.js configuration options].
14601452`slideous-url`
14611453: base URL for Slideous documents (defaults to `slideous`)
14621454
1463−`s5-url`
1464−: base URL for S5 documents (defaults to `s5/default`)
1455+[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
14651456
1466−`revealjs-url`
1467−: base URL for reveal.js documents (defaults to `reveal.js`)
1457+Variables for Beamer slides
1458+---------------------------
14681459
1469−`theme`, `colortheme`, `fonttheme`, `innertheme`, `outertheme`
1470−: themes for LaTeX [`beamer`] documents
1460+These variables change the appearance of PDF slides using [`beamer`].
14711461
1472−`themeoptions`
1473−: options for LaTeX beamer themes (a list).
1462+`aspectratio`
1463+: slide aspect ratio (`43` for 4:3 [default], `169` for 16:9,
1464+ `1610` for 16:10, `149` for 14:9, `141` for 1.41:1, `54` for 5:4,
1465+ `32` for 3:2)
1466+
1467+`beamerarticle`
1468+: produce an article from Beamer slides
1469+
1470+`beameroption`
1471+: add extra beamer option with `\setbeameroption{}`
1472+
1473+`institute`
1474+: author affiliations: can be a list when there are multiple authors
1475+
1476+`logo`
1477+: logo image for slides
14741478
14751479`navigation`
1476−: controls navigation symbols in `beamer` documents
1477− (default is `empty` for no navigation symbols; other valid values
1478− are `frame`, `vertical`, and `horizontal`).
1480+: controls navigation symbols (default is `empty` for no navigation
1481+ symbols; other valid values are `frame`, `vertical`, and `horizontal`)
14791482
14801483`section-titles`
1481−: enables on "title pages" for new sections in `beamer`
1482− documents (default = true).
1484+: enables "title pages" for new sections (default is true)
14831485
1484−`beamerarticle`
1485−: when true, the `beamerarticle` package is loaded (for
1486− producing an article from beamer slides).
1486+`theme`, `colortheme`, `fonttheme`, `innertheme`, `outertheme`
1487+: beamer themes:
14871488
1488−`aspectratio`
1489−: aspect ratio of slides (for beamer only, `1610` for 16:10, `169` for 16:9,
1490− `149` for 14:9, `141` for 1.41:1, `54` for 5:4, `43` for 4:3 which is the
1491− default, and `32` for 3:2).
1489+`themeoptions`
1490+: options for LaTeX beamer themes (a list).
14921491
1493−[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
1492+`titlegraphic`
1493+: image for title slide
14941494
14951495Variables for LaTeX
14961496-------------------
14971497
1498−LaTeX variables are used when [creating a PDF].
1499−
1500−`papersize`
1501−: paper size, e.g. `letter`, `a4`
1502−
1503−`fontsize`
1504−: font size for body text (e.g. `10pt`, `12pt`)
1498+Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
15051499
1506−`documentclass`
1507−: document class, e.g. [`article`], [`report`], [`book`], [`memoir`]
1500+### Layout
15081501
15091502`classoption`
1510−: option for document class, e.g. `oneside`; may be repeated
1511− for multiple options
1503+: option for document class, e.g. `oneside`; repeat for multiple options
15121504
1513−`beameroption`
1514−: In beamer, add extra beamer option with `\setbeameroption{}`
1505+`documentclass`
1506+: document class: usually one of the standard classes, [`article`], [`report`],
1507+ and [`book`]; the [KOMA-Script] equivalents, `scrartcl`, `scrreprt`,
1508+ and `scrbook`, which default to smaller margins; or [`memoir`]
15151509
15161510`geometry`
15171511: option for [`geometry`] package, e.g. `margin=1in`;
1518− may be repeated for multiple options
1512+ repeat for multiple options
15191513
1520−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1521−: sets margins, if `geometry` is not used (otherwise `geometry`
1522− overrides these)
1514+`indent`
1515+: uses document class settings for indentation (the default LaTeX template
1516+ otherwise removes indentation and adds space between paragraphs)
15231517
15241518`linestretch`
15251519: adjusts line spacing using the [`setspace`]
15261520 package, e.g. `1.25`, `1.5`
15271521
1522+`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1523+: sets margins if `geometry` is not used (otherwise `geometry`
1524+ overrides these)
1525+
1526+`pagestyle`
1527+: control `\pagestyle{}`: the default article class
1528+ supports `plain` (default), `empty` (no running heads or page numbers),
1529+ and `headings` (section titles in running heads)
1530+
1531+`papersize`
1532+: paper size, e.g. `letter`, `a4`
1533+
1534+`secnumdepth`
1535+: numbering depth for sections (with `--number-sections` option
1536+ or `numbersections` variable)
1537+
1538+`subparagraph`
1539+: disables default behavior of LaTeX template that redefines (sub)paragraphs
1540+ as sections, changing the appearance of nested headings in some classes
1541+
1542+### Fonts
1543+
1544+`fontenc`
1545+: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
1546+ default is `T1` (see [LaTeX font encodings guide])
1547+
15281548`fontfamily`
15291549: font package for use with `pdflatex`:
15301550 [TeX Live] includes many options, documented in the [LaTeX Font Catalogue].
15311551 The default is [Latin Modern][`lm`].
15321552
15331553`fontfamilyoptions`
1534−: options for package used as `fontfamily`: e.g. `osf,sc` with
1535− `fontfamily` set to [`mathpazo`] provides Palatino with old-style
1536− figures and true small caps; may be repeated for multiple options
1554+: options for package used as `fontfamily`; repeat for multiple options.
1555+ For example, to use the Libertine font with proportional lowercase
1556+ (old-style) figures through the [`libertinus`] package:
1557+
1558+ ---
1559+ fontfamily: libertinus
1560+ fontfamilyoptions:
1561+ - osf
1562+ - p
1563+ ...
1564+
1565+`fontsize`
1566+: font size for body text. The standard classes allow 10pt, 11pt, and 12pt.
1567+ To use another size, set `documentclass` to one of the [KOMA-Script] classes,
1568+ such as `scrartcl` or `scrbook`.
15371569
15381570`mainfont`, `sansfont`, `monofont`, `mathfont`, `CJKmainfont`
15391571: font families for use with `xelatex` or
@@ -1543,16 +1575,21 @@ LaTeX variables are used when [creating a PDF].
15431575`mainfontoptions`, `sansfontoptions`, `monofontoptions`, `mathfontoptions`, `CJKoptions`
15441576: options to use with `mainfont`, `sansfont`, `monofont`, `mathfont`,
15451577 `CJKmainfont` in `xelatex` and `lualatex`. Allow for any choices
1546− available through [`fontspec`], such as the OpenType features
1547− `Numbers=OldStyle,Numbers=Proportional`. May be repeated for multiple options.
1578+ available through [`fontspec`]; repeat for multiple options. For example,
1579+ to use the [TeX Gyre] version of Palatino with lowercase figures:
15481580
1549−`fontenc`
1550−: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
1551− default is `T1` (see guide to [LaTeX font encodings])
1581+ ---
1582+ mainfont: TeX Gyre Pagella
1583+ mainfontoptions:
1584+ - Numbers=Lowercase
1585+ - Numbers=Proportional
1586+ ...
15521587
15531588`microtypeoptions`
15541589: options to pass to the microtype package
15551590
1591+### Links
1592+
15561593`colorlinks`
15571594: add color to link text; automatically enabled if any of
15581595 `linkcolor`, `filecolor`, `citecolor`, `urlcolor`, or `toccolor` are set
@@ -1566,16 +1603,13 @@ LaTeX variables are used when [creating a PDF].
15661603`links-as-notes`
15671604: causes links to be printed as footnotes
15681605
1569−`indent`
1570−: uses document class settings for indentation (the default LaTeX template
1571− otherwise removes indentation and adds space between paragraphs)
1606+### Front matter
15721607
1573−`subparagraph`
1574−: disables default behavior of LaTeX template that redefines (sub)paragraphs
1575− as sections, changing the appearance of nested headings in some classes
1608+`lof`, `lot`
1609+: include list of figures, list of tables
15761610
15771611`thanks`
1578−: specifies contents of acknowledgments footnote after document title.
1612+: contents of acknowledgments footnote after document title
15791613
15801614`toc`
15811615: include table of contents (can also be set using `--toc/--table-of-contents`)
@@ -1583,14 +1617,12 @@ LaTeX variables are used when [creating a PDF].
15831617`toc-depth`
15841618: level of section to include in table of contents
15851619
1586−`secnumdepth`
1587−: numbering depth for sections, if sections are numbered
1620+### BibLaTeX Bibliographies
15881621
1589−`lof`, `lot`
1590−: include list of figures, list of tables
1622+These variables function when using BibLaTeX for [citation rendering].
15911623
1592−`bibliography`
1593−: bibliography to use for resolving references
1624+`biblatexoptions`
1625+: list of options for biblatex
15941626
15951627`biblio-style`
15961628: bibliography style, when used with `--natbib` and `--biblatex`.
@@ -1598,46 +1630,45 @@ LaTeX variables are used when [creating a PDF].
15981630`biblio-title`
15991631: bibliography title, when used with `--natbib` and `--biblatex`.
16001632
1601−`biblatexoptions`
1602−: list of options for biblatex.
1633+`bibliography`
1634+: bibliography to use for resolving references
16031635
16041636`natbiboptions`
1605−: list of options for natbib.
1606−
1607−`pagestyle`
1608−: An option for LaTeX's `\pagestyle{}`. The default article class
1609− supports 'plain' (default), 'empty', and 'headings'; headings puts
1610− section titles in the header.
1637+: list of options for natbib
16111638
1639+[KOMA-Script]: https://ctan.org/pkg/koma-script
1640+[LaTeX Font Catalogue]: http://www.tug.dk/FontCatalogue/
1641+[LaTeX font encodings guide]: https://ctan.org/pkg/encguide
1642+[TeX Gyre]: http://www.gust.org.pl/projects/e-foundry/tex-gyre
16121643[`article`]: https://ctan.org/pkg/article
1613−[`report`]: https://ctan.org/pkg/report
16141644[`book`]: https://ctan.org/pkg/book
1615−[KOMA-Script]: https://ctan.org/pkg/koma-script
1645+[`libertinus`]: https://ctan.org/pkg/libertinus
16161646[`memoir`]: https://ctan.org/pkg/memoir
1617−[LaTeX Font Catalogue]: http://www.tug.dk/FontCatalogue/
1618−[`mathpazo`]: https://ctan.org/pkg/mathpazo
1619−[LaTeX font encodings]: https://ctan.org/pkg/encguide
1647+[`report`]: https://ctan.org/pkg/report
16201648
16211649Variables for ConTeXt
16221650---------------------
16231651
1624−`papersize`
1625−: paper size, e.g. `letter`, `A4`, `landscape` (see [ConTeXt Paper Setup]);
1626− may be repeated for multiple options
1627−
1628−`layout`
1629−: options for page margins and text arrangement (see [ConTeXt Layout]);
1630− may be repeated for multiple options
1631−
1632−`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1633−: sets margins, if `layout` is not used (otherwise `layout`
1634− overrides these)
1652+Pandoc uses these variables when [creating a PDF] with ConTeXt.
16351653
16361654`fontsize`
16371655: font size for body text (e.g. `10pt`, `12pt`)
16381656
1639−`mainfont`, `sansfont`, `monofont`, `mathfont`
1640−: font families: take the name of any system font (see [ConTeXt Font Switching])
1657+`headertext`, `footertext`
1658+: text to be placed in running header or footer (see [ConTeXt Headers and Footers]);
1659+ repeat up to four times for different placement
1660+
1661+`indenting`
1662+: controls indentation of paragraphs, e.g. `yes,small,next` (see [ConTeXt Indentation]);
1663+ repeat for multiple options
1664+
1665+`interlinespace`
1666+: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
1667+ repeat for multiple options
1668+
1669+`layout`
1670+: options for page margins and text arrangement (see [ConTeXt Layout]);
1671+ repeat for multiple options
16411672
16421673`linkcolor`, `contrastcolor`
16431674: color for links outside and inside a page, e.g. `red`, `blue` (see [ConTeXt Color])
@@ -1645,30 +1676,23 @@ Variables for ConTeXt
16451676`linkstyle`
16461677: typeface style for links, e.g. `normal`, `bold`, `slanted`, `boldslanted`, `type`, `cap`, `small`
16471678
1648−`indenting`
1649−: controls indentation of paragraphs, e.g. `yes,small,next` (see [ConTeXt Indentation]);
1650− may be repeated for multiple options
1651−
1652−`whitespace`
1653−: spacing between paragraphs, e.g. `none`, `small` (using [`setupwhitespace`])
1679+`lof`, `lot`
1680+: include list of figures, list of tables
16541681
1655−`interlinespace`
1656−: adjusts line spacing, e.g. `4ex` (using [`setupinterlinespace`]);
1657− may be repeated for multiple options
1682+`mainfont`, `sansfont`, `monofont`, `mathfont`
1683+: font families: take the name of any system font (see [ConTeXt Font Switching])
16581684
1659−`headertext`, `footertext`
1660−: text to be placed in running header or footer (see [ConTeXt Headers and Footers]);
1661− may be repeated up to four times for different placement
1685+`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1686+: sets margins, if `layout` is not used (otherwise `layout`
1687+ overrides these)
16621688
16631689`pagenumbering`
16641690: page number style and location (using [`setuppagenumbering`]);
1665− may be repeated for multiple options
1691+ repeat for multiple options
16661692
1667−`toc`
1668−: include table of contents (can also be set using `--toc/--table-of-contents`)
1669−
1670−`lof`, `lot`
1671−: include list of figures, list of tables
1693+`papersize`
1694+: paper size, e.g. `letter`, `A4`, `landscape` (see [ConTeXt Paper Setup]);
1695+ repeat for multiple options
16721696
16731697`pdfa`
16741698: adds to the preamble the setup necessary to generate PDF/A-1b:2005.
@@ -1678,6 +1702,12 @@ Variables for ConTeXt
16781702 from [ConTeXt ICC Profiles]. See also [ConTeXt PDFA] for more
16791703 details.
16801704
1705+`toc`
1706+: include table of contents (can also be set using `--toc/--table-of-contents`)
1707+
1708+`whitespace`
1709+: spacing between paragraphs, e.g. `none`, `small` (using [`setupwhitespace`])
1710+
16811711[ConTeXt Paper Setup]: https://wiki.contextgarden.net/PaperSetup
16821712[ConTeXt Layout]: https://wiki.contextgarden.net/Layout
16831713[ConTeXt Font Switching]: https://wiki.contextgarden.net/Font_Switching
@@ -1690,40 +1720,107 @@ Variables for ConTeXt
16901720[`setupinterlinespace`]: https://wiki.contextgarden.net/Command/setupinterlinespace
16911721[`setuppagenumbering`]: https://wiki.contextgarden.net/Command/setuppagenumbering
16921722
1693−Variables for man pages
1694−-----------------------
1723+Variables for `wkhtmltopdf`
1724+---------------------------
16951725
1696−`section`
1697−: section number in man pages
1726+Pandoc uses these variables when [creating a PDF] with [`wkhtmltopdf`].
1727+The `--css` option also affects the output.
16981728
1699−`header`
1700−: header in man pages
1729+`footer-html`, `header-html`
1730+: add information to the header and footer
17011731
1702−`footer`
1703−: footer in man pages
1732+`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
1733+: set the page margins
1734+
1735+`papersize`
1736+: sets the PDF paper size
1737+
1738+Variables for man pages
1739+-----------------------
17041740
17051741`adjusting`
17061742: adjusts text to left (`l`), right (`r`), center (`c`),
17071743 or both (`b`) margins
17081744
1745+`footer`
1746+: footer in man pages
1747+
1748+`header`
1749+: header in man pages
1750+
17091751`hyphenate`
17101752: if `true` (the default), hyphenation will be used
17111753
1754+`section`
1755+: section number in man pages
1756+
17121757Variables for ms
17131758----------------
17141759
1715−`pointsize`
1716−: point size (e.g. `10p`)
1717−
1718−`lineheight`
1719−: line height (e.g. `12p`)
1720−
17211760`fontfamily`
17221761: font family (e.g. `T` or `P`)
17231762
17241763`indent`
17251764: paragraph indent (e.g. `2m`)
17261765
1766+`lineheight`
1767+: line height (e.g. `12p`)
1768+
1769+`pointsize`
1770+: point size (e.g. `10p`)
1771+
1772+Structural variables
1773+--------------------
1774+
1775+Pandoc sets these variables automatically in response to [options] or
1776+document contents; users can also modify them. These vary depending
1777+on the output format, and include the following:
1778+
1779+`body`
1780+: body of document
1781+
1782+`header-includes`
1783+: contents specified by `-H/--include-in-header` (may have multiple
1784+ values)
1785+
1786+`include-before`
1787+: contents specified by `-B/--include-before-body` (may have
1788+ multiple values)
1789+
1790+`include-after`
1791+: contents specified by `-A/--include-after-body` (may have
1792+ multiple values)
1793+
1794+`meta-json`
1795+: JSON representation of all of the document's metadata. Field
1796+ values are transformed to the selected output format.
1797+
1798+`numbersections`
1799+: non-null value if `-N/--number-sections` was specified
1800+
1801+`sourcefile`, `outputfile`
1802+: source and destination filenames, as given on the command line.
1803+ `sourcefile` can also be a list if input comes from multiple files, or empty
1804+ if input is from stdin. You can use the following snippet in your template
1805+ to distinguish them:
1806+
1807+ $if(sourcefile)$
1808+ $for(sourcefile)$
1809+ $sourcefile$
1810+ $endfor$
1811+ $else$
1812+ (stdin)
1813+ $endif$
1814+
1815+ Similarly, `outputfile` can be `-` if output goes to the terminal.
1816+
1817+`toc`
1818+: non-null value if `--toc/--table-of-contents` was specified
1819+
1820+`toc-title`
1821+: title of table of contents (works only with EPUB,
1822+ opendocument, odt, docx, pptx, beamer, LaTeX)
1823+
17271824Using variables in templates
17281825----------------------------
17291826
@@ -4352,7 +4449,7 @@ For Slidy, Slideous, reveal.js, and S5, the file produced by pandoc with the
43524449assumed to be available at the relative path `s5/default` (for S5), `slideous`
43534450(for Slideous), `reveal.js` (for reveal.js), or at the Slidy website at
43544451`w3.org` (for Slidy). (These paths can be changed by setting the `slidy-url`,
4355−`slideous-url`, `revealjs-url`, or `s5-url` variables; see [Variables for slides],
4452+`slideous-url`, `revealjs-url`, or `s5-url` variables; see [Variables for HTML slides],
43564453above.) For DZSlides, the (relatively short) JavaScript and CSS are included in
43574454the file by default.
43584455
@@ -5059,7 +5156,7 @@ application, here are some things to keep in mind:
50595156Authors
50605157=======
50615158
5062−Copyright 2006-2017 John MacFarlane (jgm@berkeley.edu). Released
5159+Copyright 2006--2019 John MacFarlane (jgm@berkeley.edu). Released
50635160under the [GPL], version 2 or greater. This software carries no
50645161warranty of any kind. (See COPYRIGHT for full copyright and
50655162warranty notices.) For a full list of contributors, see the file