@@ -1426,7 +1426,8 @@ command line using the `-V/--variable` option. If a variable is not set,
14261426pandoc will look for the key in the document's metadata, which can be set
14271427using either [YAML metadata blocks][Extension: `yaml_metadata_block`]
14281428or with the `-M/--metadata` option. In addition, some variables
1429−are given default values by pandoc.
1429+are given default values by pandoc. See [Variables] below for
1430+a list of variables used in pandoc's default templates.
14301431
14311432If you use custom templates, you may need to revise them as pandoc
14321433changes. We recommend tracking the changes in the default templates,
@@ -1684,8 +1685,9 @@ $for(article)$
16841685$endfor$
16851686```
16861687
1688+## Variables
16871689
1688−## Metadata variables
1690+### Metadata variables
16891691
16901692`title`, `author`, `date`
16911693: allow identification of basic aspects of the document. Included
@@ -1750,7 +1752,7 @@ will include `title`, `author` and `description` as standard document
17501752properties and `subtitle` as a custom property when converting to docx,
17511753ODT or pptx.
17521754
1753−## Language variables
1755+### Language variables
17541756
17551757`lang`
17561758: identifies the main language of the document using IETF language
@@ -1792,7 +1794,7 @@ ODT or pptx.
17921794[Unicode Bidirectional Algorithm]: http://www.w3.org/International/articles/inline-bidi-markup/uba-basics
17931795[Language subtag lookup]: https://r12a.github.io/app-subtags/
17941796
1795−## Variables for HTML slides
1797+### Variables for HTML slides
17961798
17971799These affect HTML output when [producing slide shows with pandoc].
17981800
@@ -1814,7 +1816,7 @@ To turn off boolean flags that default to true in reveal.js, use `0`.
18141816
18151817[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
18161818
1817−## Variables for Beamer slides
1819+### Variables for Beamer slides
18181820
18191821These variables change the appearance of PDF slides using [`beamer`].
18201822
@@ -1843,7 +1845,7 @@ These variables change the appearance of PDF slides using [`beamer`].
18431845: enables "title pages" for new sections (default is true)
18441846
18451847`theme`, `colortheme`, `fonttheme`, `innertheme`, `outertheme`
1846−: beamer themes:
1848+: beamer themes
18471849
18481850`themeoptions`
18491851: options for LaTeX beamer themes (a list).
@@ -1851,26 +1853,27 @@ These variables change the appearance of PDF slides using [`beamer`].
18511853`titlegraphic`
18521854: image for title slide
18531855
1854−## Variables for PowerPoint slide shows
1856+### Variables for PowerPoint
18551857
1856−These variables control the visual aspects of a slide show that are not easily
1857−controled via templates.
1858+These variables control the visual aspects of a slide show that
1859+are not easily controled via templates.
18581860
18591861`monofont`
18601862: font to use for code.
18611863
1862−## Variables for LaTeX
1864+### Variables for LaTeX
18631865
18641866Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
18651867
1866−### Layout
1868+#### Layout
18671869
18681870`block-headings`
1869−: make `\paragraph` and `\subparagraph` (fourth- and fifth-level headings, or
1870− fifth- and sixth-level with book classes) free-standing rather than run-in;
1871− requires further formatting to distinguish from `\subsubsection` (third- or
1872− fourth-level headings). Instead of using this option, [KOMA-Script] can adjust
1873− headings more extensively:
1871+: make `\paragraph` and `\subparagraph` (fourth- and
1872+ fifth-level headings, or fifth- and sixth-level with book
1873+ classes) free-standing rather than run-in; requires further
1874+ formatting to distinguish from `\subsubsection` (third- or
1875+ fourth-level headings). Instead of using this option,
1876+ [KOMA-Script] can adjust headings more extensively:
18741877
18751878 ---
18761879 documentclass: scrartcl
@@ -1935,7 +1938,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
19351938: numbering depth for sections (with `--number-sections` option
19361939 or `numbersections` variable)
19371940
1938−### Fonts
1941+#### Fonts
19391942
19401943`fontenc`
19411944: allows font encoding to be specified through `fontenc` package (with `pdflatex`);
@@ -1959,9 +1962,9 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
19591962 ...
19601963
19611964`fontsize`
1962−: font size for body text. The standard classes allow 10pt, 11pt, and 12pt.
1963− To use another size, set `documentclass` to one of the [KOMA-Script] classes,
1964− such as `scrartcl` or `scrbook`.
1965+: font size for body text. The standard classes allow 10pt, 11pt, and
1966+ 12pt. To use another size, set `documentclass` to one of
1967+ the [KOMA-Script] classes, such as `scrartcl` or `scrbook`.
19651968
19661969`mainfont`, `sansfont`, `monofont`, `mathfont`, `CJKmainfont`
19671970: font families for use with `xelatex` or
@@ -1970,9 +1973,10 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
19701973
19711974`mainfontoptions`, `sansfontoptions`, `monofontoptions`, `mathfontoptions`, `CJKoptions`
19721975: options to use with `mainfont`, `sansfont`, `monofont`, `mathfont`,
1973− `CJKmainfont` in `xelatex` and `lualatex`. Allow for any choices
1974− available through [`fontspec`]; repeat for multiple options. For example,
1975− to use the [TeX Gyre] version of Palatino with lowercase figures:
1976+ `CJKmainfont` in `xelatex` and `lualatex`. Allow for any
1977+ choices available through [`fontspec`]; repeat for multiple
1978+ options. For example, to use the [TeX Gyre] version of
1979+ Palatino with lowercase figures:
19761980
19771981 ---
19781982 mainfont: TeX Gyre Pagella
@@ -1984,7 +1988,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
19841988`microtypeoptions`
19851989: options to pass to the microtype package
19861990
1987−### Links
1991+#### Links
19881992
19891993`colorlinks`
19901994: add color to link text; automatically enabled if any of
@@ -1999,7 +2003,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
19992003`links-as-notes`
20002004: causes links to be printed as footnotes
20012005
2002−### Front matter
2006+#### Front matter
20032007
20042008`lof`, `lot`
20052009: include list of figures, list of tables
@@ -2013,7 +2017,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
20132017`toc-depth`
20142018: level of section to include in table of contents
20152019
2016−### BibLaTeX Bibliographies
2020+#### BibLaTeX Bibliographies
20172021
20182022These variables function when using BibLaTeX for [citation rendering].
20192023
@@ -2042,7 +2046,7 @@ These variables function when using BibLaTeX for [citation rendering].
20422046[`memoir`]: https://ctan.org/pkg/memoir
20432047[`report`]: https://ctan.org/pkg/report
20442048
2045−## Variables for ConTeXt
2049+### Variables for ConTeXt
20462050
20472051Pandoc uses these variables when [creating a PDF] with ConTeXt.
20482052
@@ -2134,7 +2138,7 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
21342138[`setupinterlinespace`]: https://wiki.contextgarden.net/Command/setupinterlinespace
21352139[`setuppagenumbering`]: https://wiki.contextgarden.net/Command/setuppagenumbering
21362140
2137−## Variables for `wkhtmltopdf`
2141+### Variables for `wkhtmltopdf`
21382142
21392143Pandoc uses these variables when [creating a PDF] with [`wkhtmltopdf`].
21402144The `--css` option also affects the output.
@@ -2148,7 +2152,7 @@ The `--css` option also affects the output.
21482152`papersize`
21492153: sets the PDF paper size
21502154
2151−## Variables for man pages
2155+### Variables for man pages
21522156
21532157`adjusting`
21542158: adjusts text to left (`l`), right (`r`), center (`c`),
@@ -2166,7 +2170,7 @@ The `--css` option also affects the output.
21662170`section`
21672171: section number in man pages
21682172
2169−## Variables for ms
2173+### Variables for ms
21702174
21712175`fontfamily`
21722176: font family (e.g. `T` or `P`)
@@ -2180,7 +2184,7 @@ The `--css` option also affects the output.
21802184`pointsize`
21812185: point size (e.g. `10p`)
21822186
2183−## Structural variables
2187+### Variables set automatically
21842188
21852189Pandoc sets these variables automatically in response to [options] or
21862190document contents; users can also modify them. These vary depending
@@ -2220,9 +2224,9 @@ on the output format, and include the following:
22202224
22212225`sourcefile`, `outputfile`
22222226: source and destination filenames, as given on the command line.
2223− `sourcefile` can also be a list if input comes from multiple files, or empty
2224− if input is from stdin. You can use the following snippet in your template
2225− to distinguish them:
2227+ `sourcefile` can also be a list if input comes from multiple files,
2228+ or empty if input is from stdin. You can use the following snippet in
2229+ your template to distinguish them:
22262230
22272231 $if(sourcefile)$
22282232 $for(sourcefile)$