@@ -9,22 +9,24 @@ pandoc - general markup converter
99.PP
1010Pandoc is a Haskell library for converting from one markup format to
1111another, and a command\-line tool that uses this library.
12−It can read Markdown, CommonMark, and (subsets of) Textile,
13−reStructuredText, HTML, LaTeX, MediaWiki markup, TWiki markup, Haddock
14−markup, OPML, Emacs Org\-mode, DocBook, txt2tags, EPUB, ODT and Word
15−docx; and it can write plain text, Markdown, reStructuredText, XHTML,
16−HTML 5, LaTeX (including beamer slide shows), ConTeXt, RTF, OPML,
17−DocBook, OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup,
18−DokuWiki markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile,
19−groff man pages, Emacs Org\-Mode, AsciiDoc, InDesign ICML, and Slidy,
20−Slideous, DZSlides, reveal.js or S5 HTML slide shows.
12+It can read Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
13+Markdown, and (subsets of) Textile, reStructuredText, HTML, LaTeX,
14+MediaWiki markup, TWiki markup, Haddock markup, OPML, Emacs Org mode,
15+DocBook, txt2tags, EPUB, ODT and Word docx; and it can write plain text,
16+Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored Markdown,
17+reStructuredText, XHTML, HTML5, LaTeX (including \f[C]beamer\f[] slide
18+shows), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU
19+Texinfo, MediaWiki markup, DokuWiki markup, Haddock markup, EPUB (v2 or
20+v3), FictionBook2, Textile, groff man pages, Emacs Org mode, AsciiDoc,
21+InDesign ICML, and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide
22+shows.
2123It can also produce PDF output on systems where LaTeX is installed.
2224.PP
2325Pandoc\[aq]s enhanced version of markdown includes syntax for footnotes,
2426tables, flexible ordered lists, definition lists, fenced code blocks,
25−superscript, subscript, strikeout, title blocks, automatic tables of
26−contents, embedded LaTeX math, citations, and markdown inside HTML block
27−elements.
27+superscripts and subscripts, strikeout, metadata blocks, automatic
28+tables of contents, embedded LaTeX math, citations, and markdown inside
29+HTML block elements.
2830(These enhancements, described below under Pandoc\[aq]s markdown, can be
2931disabled using the \f[C]markdown_strict\f[] input or output format.)
3032.PP
@@ -105,7 +107,7 @@ pandoc\ \-f\ markdown\ \-t\ latex\ hello.txt
105107\f[]
106108.fi
107109.PP
108−To convert \f[C]hello.html\f[] from html to markdown:
110+To convert \f[C]hello.html\f[] from HTML to markdown:
109111.IP
110112.nf
111113\f[C]
@@ -156,14 +158,9 @@ included in the document header, which will only be included if you use
156158the \f[C]\-s/\-\-standalone\f[] option.
157159.SS Creating a PDF
158160.PP
159−Earlier versions of pandoc came with a program, \f[C]markdown2pdf\f[],
160−that used pandoc and pdflatex to produce a PDF.
161−This is no longer needed, since \f[C]pandoc\f[] can now produce
162−\f[C]pdf\f[] output itself.
163−To produce a PDF, simply specify an output file with a \f[C]\&.pdf\f[]
161+To produce a PDF, specify an output file with a \f[C]\&.pdf\f[]
164162extension.
165−Pandoc will create a latex file and use pdflatex (or another engine, see
166−\f[C]\-\-latex\-engine\f[]) to convert it to PDF:
163+Pandoc will use LaTeX to convert it to PDF:
167164.IP
168165.nf
169166\f[C]
@@ -173,15 +170,27 @@ pandoc\ test.txt\ \-o\ test.pdf
173170.PP
174171Production of a PDF requires that a LaTeX engine be installed (see
175172\f[C]\-\-latex\-engine\f[], below), and assumes that the following LaTeX
176−packages are available: \f[C]amssymb\f[], \f[C]amsmath\f[],
177−\f[C]ifxetex\f[], \f[C]ifluatex\f[], \f[C]listings\f[] (if the
178−\f[C]\-\-listings\f[] option is used), \f[C]fancyvrb\f[],
179−\f[C]longtable\f[], \f[C]booktabs\f[], \f[C]url\f[], \f[C]graphicx\f[]
180−and \f[C]grffile\f[] (if the document contains images),
181−\f[C]hyperref\f[], \f[C]ulem\f[], \f[C]babel\f[] (if the \f[C]lang\f[]
182−variable is set), \f[C]fontspec\f[] (if \f[C]xelatex\f[] or
183−\f[C]lualatex\f[] is used as the LaTeX engine), \f[C]xltxtra\f[] and
184−\f[C]xunicode\f[] (if \f[C]xelatex\f[] is used).
173+packages are available: \f[C]amsfonts\f[], \f[C]amsmath\f[],
174+\f[C]lm\f[], \f[C]ifxetex\f[], \f[C]ifluatex\f[], \f[C]eurosym\f[],
175+\f[C]listings\f[] (if the \f[C]\-\-listings\f[] option is used),
176+\f[C]fancyvrb\f[], \f[C]longtable\f[], \f[C]booktabs\f[], \f[C]url\f[],
177+\f[C]graphicx\f[] and \f[C]grffile\f[] (if the document contains
178+images), \f[C]color\f[], \f[C]hyperref\f[], \f[C]ulem\f[],
179+\f[C]geometry\f[] (with the \f[C]geometry\f[] variable set),
180+\f[C]setspace\f[] (with \f[C]linestretch\f[]), and \f[C]babel\f[] (with
181+\f[C]lang\f[]).
182+The use of \f[C]xelatex\f[] or \f[C]lualatex\f[] as the LaTeX engine
183+requires \f[C]fontspec\f[]; \f[C]xelatex\f[] uses \f[C]mathspec\f[],
184+\f[C]polyglossia\f[] (with \f[C]lang\f[]), \f[C]xecjk\f[], and
185+\f[C]bidi\f[] (with the \f[C]dir\f[] variable set).
186+The \f[C]upquote\f[] and \f[C]microtype\f[] packages are used if
187+available, and \f[C]csquotes\f[] will be used for smart punctuation if
188+added to the template.
189+The \f[C]natbib\f[], \f[C]biblatex\f[], \f[C]bibtex\f[], and
190+\f[C]biber\f[] packages can optionally be used for citation rendering.
191+These are included with all recent versions of TeX Live.
192+.PP
193+PDF output can be controlled using variables for LaTeX.
185194.SS \f[C]hsmarkdown\f[]
186195.PP
187196A user who wants a drop\-in replacement for \f[C]Markdown.pl\f[] may
@@ -191,8 +200,8 @@ When invoked under the name \f[C]hsmarkdown\f[], \f[C]pandoc\f[] will
191200behave as if invoked with
192201\f[C]\-f\ markdown_strict\ \-\-email\-obfuscation=references\f[], and
193202all command\-line options will be treated as regular arguments.
194−However, this approach does not work under Cygwin, due to problems with
195−its simulation of symbolic links.
203+This approach does not work under Cygwin, due to problems with its
204+simulation of symbolic links.
196205.SH OPTIONS
197206.SS General options
198207.TP
@@ -201,13 +210,13 @@ Specify input format.
201210\f[I]FORMAT\f[] can be \f[C]native\f[] (native Haskell), \f[C]json\f[]
202211(JSON version of native AST), \f[C]markdown\f[] (pandoc\[aq]s extended
203212markdown), \f[C]markdown_strict\f[] (original unextended markdown),
204−\f[C]markdown_phpextra\f[] (PHP Markdown Extra extended markdown),
205−\f[C]markdown_github\f[] (github extended markdown), \f[C]commonmark\f[]
206−(CommonMark markdown), \f[C]textile\f[] (Textile), \f[C]rst\f[]
207−(reStructuredText), \f[C]html\f[] (HTML), \f[C]docbook\f[] (DocBook),
208−\f[C]t2t\f[] (txt2tags), \f[C]docx\f[] (docx), \f[C]odt\f[] (ODT),
209−\f[C]epub\f[] (EPUB), \f[C]opml\f[] (OPML), \f[C]org\f[] (Emacs
210−Org\-mode), \f[C]mediawiki\f[] (MediaWiki markup), \f[C]twiki\f[] (TWiki
213+\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
214+\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
215+\f[C]commonmark\f[] (CommonMark markdown), \f[C]textile\f[] (Textile),
216+\f[C]rst\f[] (reStructuredText), \f[C]html\f[] (HTML), \f[C]docbook\f[]
217+(DocBook), \f[C]t2t\f[] (txt2tags), \f[C]docx\f[] (docx), \f[C]odt\f[]
218+(ODT), \f[C]epub\f[] (EPUB), \f[C]opml\f[] (OPML), \f[C]org\f[] (Emacs
219+Org mode), \f[C]mediawiki\f[] (MediaWiki markup), \f[C]twiki\f[] (TWiki
211220markup), \f[C]haddock\f[] (Haddock markup), or \f[C]latex\f[] (LaTeX).
212221If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],
213222\f[C]latex\f[], or \f[C]html\f[], the input will be treated as literate
@@ -230,25 +239,25 @@ Specify output format.
230239(JSON version of native AST), \f[C]plain\f[] (plain text),
231240\f[C]markdown\f[] (pandoc\[aq]s extended markdown),
232241\f[C]markdown_strict\f[] (original unextended markdown),
233−\f[C]markdown_phpextra\f[] (PHP Markdown extra extended markdown),
234−\f[C]markdown_github\f[] (github extended markdown), \f[C]commonmark\f[]
235−(CommonMark markdown), \f[C]rst\f[] (reStructuredText), \f[C]html\f[]
236−(XHTML 1), \f[C]html5\f[] (HTML 5), \f[C]latex\f[] (LaTeX),
237−\f[C]beamer\f[] (LaTeX beamer slide show), \f[C]context\f[] (ConTeXt),
238−\f[C]man\f[] (groff man), \f[C]mediawiki\f[] (MediaWiki markup),
239−\f[C]dokuwiki\f[] (DokuWiki markup), \f[C]textile\f[] (Textile),
240−\f[C]org\f[] (Emacs Org\-Mode), \f[C]texinfo\f[] (GNU Texinfo),
241−\f[C]opml\f[] (OPML), \f[C]docbook\f[] (DocBook), \f[C]opendocument\f[]
242−(OpenDocument), \f[C]odt\f[] (OpenOffice text document), \f[C]docx\f[]
243−(Word docx), \f[C]haddock\f[] (Haddock markup), \f[C]rtf\f[] (rich text
244−format), \f[C]epub\f[] (EPUB v2 book), \f[C]epub3\f[] (EPUB v3),
245−\f[C]fb2\f[] (FictionBook2 e\-book), \f[C]asciidoc\f[] (AsciiDoc),
246−\f[C]icml\f[] (InDesign ICML), \f[C]slidy\f[] (Slidy HTML and javascript
247−slide show), \f[C]slideous\f[] (Slideous HTML and javascript slide
248−show), \f[C]dzslides\f[] (DZSlides HTML5 + javascript slide show),
249−\f[C]revealjs\f[] (reveal.js HTML5 + javascript slide show), \f[C]s5\f[]
250−(S5 HTML and javascript slide show), or the path of a custom lua writer
251−(see Custom writers, below).
242+\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
243+\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
244+\f[C]commonmark\f[] (CommonMark markdown), \f[C]rst\f[]
245+(reStructuredText), \f[C]html\f[] (XHTML), \f[C]html5\f[] (HTML5),
246+\f[C]latex\f[] (LaTeX), \f[C]beamer\f[] (LaTeX beamer slide show),
247+\f[C]context\f[] (ConTeXt), \f[C]man\f[] (groff man), \f[C]mediawiki\f[]
248+(MediaWiki markup), \f[C]dokuwiki\f[] (DokuWiki markup),
249+\f[C]textile\f[] (Textile), \f[C]org\f[] (Emacs Org mode),
250+\f[C]texinfo\f[] (GNU Texinfo), \f[C]opml\f[] (OPML), \f[C]docbook\f[]
251+(DocBook), \f[C]opendocument\f[] (OpenDocument), \f[C]odt\f[]
252+(OpenOffice text document), \f[C]docx\f[] (Word docx), \f[C]haddock\f[]
253+(Haddock markup), \f[C]rtf\f[] (rich text format), \f[C]epub\f[] (EPUB
254+v2 book), \f[C]epub3\f[] (EPUB v3), \f[C]fb2\f[] (FictionBook2 e\-book),
255+\f[C]asciidoc\f[] (AsciiDoc), \f[C]icml\f[] (InDesign ICML),
256+\f[C]slidy\f[] (Slidy HTML and javascript slide show), \f[C]slideous\f[]
257+(Slideous HTML and javascript slide show), \f[C]dzslides\f[] (DZSlides
258+HTML5 + javascript slide show), \f[C]revealjs\f[] (reveal.js HTML5 +
259+javascript slide show), \f[C]s5\f[] (S5 HTML and javascript slide show),
260+or the path of a custom lua writer (see Custom writers, below).
252261Note that \f[C]odt\f[], \f[C]epub\f[], and \f[C]epub3\f[] output will
253262not be directed to \f[I]stdout\f[]; an output filename must be specified
254263using the \f[C]\-o/\-\-output\f[] option.
@@ -274,7 +283,7 @@ If \f[I]FILE\f[] is \f[C]\-\f[], output will go to \f[I]stdout\f[].
274283Specify the user data directory to search for pandoc data files.
275284If this option is not specified, the default user data directory will be
276285used.
277−This is
286+This is, in Unix:
278287.RS
279288.IP
280289.nf
@@ -283,7 +292,7 @@ $HOME/.pandoc
283292\f[]
284293.fi
285294.PP
286−in unix,
295+in Windows XP:
287296.IP
288297.nf
289298\f[C]
@@ -291,7 +300,7 @@ C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\pandoc
291300\f[]
292301.fi
293302.PP
294−in Windows XP, and
303+and in Windows Vista or later:
295304.IP
296305.nf
297306\f[C]
@@ -299,18 +308,17 @@ C:\\Users\\USERNAME\\AppData\\Roaming\\pandoc
299308\f[]
300309.fi
301310.PP
302−in Windows 7.
303−(You can find the default user data directory on your system by looking
304−at the output of \f[C]pandoc\ \-\-version\f[].) A
305−\f[C]reference.odt\f[], \f[C]reference.docx\f[], \f[C]default.csl\f[],
306−\f[C]epub.css\f[], \f[C]templates\f[], \f[C]slidy\f[],
307−\f[C]slideous\f[], or \f[C]s5\f[] directory placed in this directory
308−will override pandoc\[aq]s normal defaults.
311+You can find the default user data directory on your system by looking
312+at the output of \f[C]pandoc\ \-\-version\f[].
313+A \f[C]reference.odt\f[], \f[C]reference.docx\f[], \f[C]epub.css\f[],
314+\f[C]templates\f[], \f[C]slidy\f[], \f[C]slideous\f[], or \f[C]s5\f[]
315+directory placed in this directory will override pandoc\[aq]s normal
316+defaults.
309317.RE
310318.TP
311−.B \f[C]\-\-bash\-completiion\f[]
319+.B \f[C]\-\-bash\-completion\f[]
312320Generate a bash completion script.
313−to enable bash completion with pandoc, add this to your
321+To enable bash completion with pandoc, add this to your
314322\f[C]\&.bashrc\f[]:
315323.RS
316324.IP
@@ -426,8 +434,6 @@ Filters may be written in any language.
426434writing filters in Haskell.
427435Those who would prefer to write filters in python can use the module
428436\f[C]pandocfilters\f[], installable from PyPI.
429−See http://github.com/jgm/pandocfilters for the module and several
430−examples.
431437There are also pandoc filter libraries in PHP, perl, and
432438javascript/node.js.
433439.PP
@@ -473,7 +479,7 @@ Specify the number of spaces per tab (default is 4).
473479.TP
474480.B \f[C]\-\-track\-changes=accept\f[]|\f[C]reject\f[]|\f[C]all\f[]
475481Specifies what to do with insertions and deletions produced by the MS
476−Word "track\-changes" feature.
482+Word "Track Changes" feature.
477483\f[C]accept\f[] (the default), inserts all insertions, and ignores all
478484deletions.
479485\f[C]reject\f[] inserts all deletions and ignores insertions.
@@ -506,7 +512,7 @@ This option is set automatically for \f[C]pdf\f[], \f[C]epub\f[],
506512.B \f[C]\-\-template=\f[]\f[I]FILE\f[]
507513Use \f[I]FILE\f[] as a custom template for the generated document.
508514Implies \f[C]\-\-standalone\f[].
509−See Templates below for a description of template syntax.
515+See Templates, below, for a description of template syntax.
510516If no extension is specified, an extension corresponding to the writer
511517will be added, so that \f[C]\-\-template=special\f[] looks for
512518\f[C]special.html\f[] for HTML output.
@@ -674,7 +680,7 @@ By default inline links are used.
674680.RE
675681.TP
676682.B \f[C]\-\-atx\-headers\f[]
677−Use ATX style headers in markdown and asciidoc output.
683+Use ATX\-style headers in markdown and asciidoc output.
678684The default is to use setext\-style headers for levels 1\-2, and then
679685ATX headers.
680686.RS
@@ -683,8 +689,8 @@ ATX headers.
683689.B \f[C]\-\-chapters\f[]
684690Treat top\-level headers as chapters in LaTeX, ConTeXt, and DocBook
685691output.
686−When the LaTeX template uses the report, book, or memoir class, this
687−option is implied.
692+When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
693+or \f[C]memoir\f[], this option is implied.
688694If \f[C]beamer\f[] is the output format, top\-level headers will become
689695\f[C]\\part{..}\f[].
690696.RS
@@ -716,8 +722,8 @@ Implies \f[C]\-\-number\-sections\f[].
716722Do not convert quotation marks, apostrophes, and dashes to the TeX
717723ligatures when writing LaTeX or ConTeXt.
718724Instead, just use literal unicode characters.
719−This is needed for using advanced OpenType features with XeLaTeX and
720−LuaLaTeX.
725+This is needed for using advanced OpenType features with
726+\f[C]xelatex\f[] and \f[C]lualatex\f[].
721727Note: normally \f[C]\-\-smart\f[] is selected automatically for LaTeX
722728and ConTeXt output, but it must be specified explicitly if
723729\f[C]\-\-no\-tex\-ligatures\f[] is selected.
@@ -728,7 +734,7 @@ then you may want to use \f[C]\-\-no\-tex\-ligatures\f[] without
728734.RE
729735.TP
730736.B \f[C]\-\-listings\f[]
731−Use listings package for LaTeX code blocks
737+Use the \f[C]listings\f[] package for LaTeX code blocks
732738.RS
733739.RE
734740.TP
@@ -746,7 +752,7 @@ Headers above this level in the hierarchy are used to divide the slide
746752show into sections; headers below this level create subheads within a
747753slide.
748754The default is to set the slide level based on the contents of the
749−document; see Structuring the slide show, below.
755+document; see Structuring the slide show.
750756.RS
751757.RE
752758.TP
@@ -846,8 +852,7 @@ below).
846852.TP
847853.B \f[C]\-\-epub\-metadata=\f[]\f[I]FILE\f[]
848854Look in the specified XML file for metadata for the EPUB.
849−The file should contain a series of Dublin Core elements, as documented
850−at http://dublincore.org/documents/dces/.
855+The file should contain a series of Dublin Core elements.
851856For example:
852857.RS
853858.IP
@@ -975,20 +980,20 @@ only relevant with \f[C]pandoc\-citeproc\f[].
975980.RE
976981.TP
977982.B \f[C]\-\-natbib\f[]
978−Use natbib for citations in LaTeX output.
983+Use \f[C]natbib\f[] for citations in LaTeX output.
979984This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
980985with PDF output.
981986It is intended for use in producing a LaTeX file that can be processed
982−with pdflatex and bibtex.
987+with \f[C]bibtex\f[].
983988.RS
984989.RE
985990.TP
986991.B \f[C]\-\-biblatex\f[]
987−Use biblatex for citations in LaTeX output.
992+Use \f[C]biblatex\f[] for citations in LaTeX output.
988993This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
989994with PDF output.
990995It is intended for use in producing a LaTeX file that can be processed
991−with pdflatex and bibtex or biber.
996+with \f[C]bibtex\f[] or \f[C]biber\f[].
992997.RS
993998.RE
994999.SS Math rendering in HTML
@@ -1116,42 +1121,55 @@ To see the default template that is used, just type
11161121.IP
11171122.nf
11181123\f[C]
1119−pandoc\ \-D\ FORMAT
1124+pandoc\ \-D\ *FORMAT*
11201125\f[]
11211126.fi
11221127.PP
1123−where \f[C]FORMAT\f[] is the name of the output format.
1128+where \f[I]FORMAT\f[] is the name of the output format.
11241129A custom template can be specified using the \f[C]\-\-template\f[]
11251130option.
11261131You can also override the system default templates for a given output
1127−format \f[C]FORMAT\f[] by putting a file
1128−\f[C]templates/default.FORMAT\f[] in the user data directory (see
1132+format \f[I]FORMAT\f[] by putting a file
1133+\f[C]templates/default.*FORMAT*\f[] in the user data directory (see
11291134\f[C]\-\-data\-dir\f[], above).
11301135\f[I]Exceptions:\f[] For \f[C]odt\f[] output, customize the
11311136\f[C]default.opendocument\f[] template.
11321137For \f[C]pdf\f[] output, customize the \f[C]default.latex\f[] template.
11331138.PP
1134−Templates may contain \f[I]variables\f[].
1135−Variable names are sequences of alphanumerics, \f[C]\-\f[], and
1136−\f[C]_\f[], starting with a letter.
1137−A variable name surrounded by \f[C]$\f[] signs will be replaced by its
1138−value.
1139−For example, the string \f[C]$title$\f[] in
1139+Templates contain \f[I]variables\f[], which allow for the inclusion of
1140+arbitrary information at any point in the file.
1141+Variables may be set within the document using YAML metadata blocks.
1142+They may also be set at the command line using the
1143+\f[C]\-V/\-\-variable\f[] option: variables set in this way override
1144+metadata fields with the same name.
1145+.SS Variables set by pandoc
1146+.PP
1147+Some variables are set automatically by pandoc.
1148+These vary somewhat depending on the output format, but include metadata
1149+fields as well as the following:
1150+.TP
1151+.B \f[C]title\f[], \f[C]author\f[], \f[C]date\f[]
1152+allow identification of basic aspects of the document.
1153+Included in PDF metadata through LaTeX.
1154+These can be set through a pandoc title block, which allows for multiple
1155+authors, or through a YAML metadata block:
1156+.RS
11401157.IP
11411158.nf
11421159\f[C]
1143−<title>$title$</title>
1160+\-\-\-
1161+author:
1162+\-\ Aristotle
1163+\-\ Peter\ Abelard
1164+\&...
11441165\f[]
11451166.fi
1146−.PP
1147−will be replaced by the document title.
1148−.PP
1149−To write a literal \f[C]$\f[] in a template, use \f[C]$$\f[].
1150−.PP
1151−Some variables are set automatically by pandoc.
1152−These vary somewhat depending on the output format, but include metadata
1153−fields (such as \f[C]title\f[], \f[C]author\f[], and \f[C]date\f[]) as
1154−well as the following:
1167+.RE
1168+.TP
1169+.B \f[C]abstract\f[]
1170+allows for specification of document summary in LaTeX and Word docx
1171+.RS
1172+.RE
11551173.TP
11561174.B \f[C]header\-includes\f[]
11571175contents specified by \f[C]\-H/\-\-include\-in\-header\f[] (may have
@@ -1181,12 +1199,50 @@ multiple values)
11811199body of document
11821200.RS
11831201.RE
1202+.SS Language variables
11841203.TP
11851204.B \f[C]lang\f[]
1186−language code for HTML or LaTeX documents
1205+identifies the main language of the document, using a code according to
1206+BCP 47 (e.g.
1207+\f[C]en\f[] or \f[C]en\-GB\f[]).
1208+For some output formats, pandoc will convert it to an appropriate format
1209+stored in the additional variables \f[C]babel\-lang\f[],
1210+\f[C]polyglossia\-lang\f[] (LaTeX) and \f[C]context\-lang\f[] (ConTeXt).
11871211.RS
11881212.RE
11891213.TP
1214+.B \f[C]otherlangs\f[]
1215+a list of other languages used in the document in the YAML metadata,
1216+according to BCP 47.
1217+For example: \f[C]otherlangs:\ [en\-GB,\ fr]\f[].
1218+Currently only used by \f[C]xelatex\f[] through the generated
1219+\f[C]polyglossia\-otherlangs\f[] variable.
1220+.RS
1221+.RE
1222+.TP
1223+.B \f[C]dir\f[]
1224+the base direction of the document, either \f[C]rtl\f[]
1225+(right\-to\-left) or \f[C]ltr\f[] (left\-to\-right).
1226+.RS
1227+.PP
1228+For bidirectional documents, native pandoc \f[C]span\f[]s and
1229+\f[C]div\f[]s with the \f[C]dir\f[] attribute (value \f[C]rtl\f[] or
1230+\f[C]ltr\f[]) can be used to override the base direction in some output
1231+formats.
1232+This may not always be necessary if the final renderer (e.g.
1233+the browser, when generating HTML) supports the Unicode Bidirectional
1234+Algorithm.
1235+.PP
1236+LaTeX and ConTeXt assume by default that all text is left\-to\-right.
1237+Setting \f[C]dir:\ ltr\f[] enables bidirectional text handling in a
1238+document whose base direction is left\-to\-right but contains some
1239+right\-to\-left script.
1240+.PP
1241+When using LaTeX for bidirectional documents, only the \f[C]xelatex\f[]
1242+engine is fully supported (use \f[C]\-\-latex\-engine=xelatex\f[]).
1243+.RE
1244+.SS Variables for slides
1245+.TP
11901246.B \f[C]slidy\-url\f[]
11911247base URL for Slidy documents (defaults to
11921248\f[C]http://www.w3.org/Talks/Tools/Slidy2\f[])
@@ -1214,84 +1270,112 @@ reveal.js or LaTeX beamer theme
12141270.RE
12151271.TP
12161272.B \f[C]transition\f[]
1217−reveal.js transition
1273+reveal.js transition: \f[C]cube\f[], \f[C]page\f[], \f[C]concave\f[],
1274+\f[C]zoom\f[], \f[C]linear\f[], \f[C]fade\f[], or \f[C]none\f[]
12181275.RS
12191276.RE
12201277.TP
1221−.B \f[C]fontsize\f[]
1222−font size (10pt, 11pt, 12pt) for LaTeX documents
1278+.B \f[C]center\f[]
1279+enables vertical centering of slides in reveal.js
12231280.RS
12241281.RE
12251282.TP
1226−.B \f[C]documentclass\f[]
1227−document class for LaTeX documents
1283+.B \f[C]maxScale\f[]
1284+bounds for smallest/largest possible content scale in reveal.js
1285+(default: 1.5)
12281286.RS
12291287.RE
12301288.TP
1231−.B \f[C]classoption\f[]
1232−option for LaTeX documentclass, e.g.
1233−\f[C]oneside\f[]; may be repeated for multiple options
1289+.B \f[C]slideNumber\f[]
1290+enables display of the page number of the current slide in reveal.js
12341291.RS
12351292.RE
12361293.TP
1237−.B \f[C]geometry\f[]
1238−options for LaTeX \f[C]geometry\f[] class, e.g.
1239−\f[C]margin=1in\f[]; may be repeated for multiple options
1294+.B \f[C]colortheme\f[], \f[C]fonttheme\f[], \f[C]innertheme\f[], \f[C]outertheme\f[]
1295+themes for LaTeX \f[C]beamer\f[] documents
12401296.RS
12411297.RE
12421298.TP
1243−.B \f[C]linestretch\f[]
1244−adjusts line spacing (requires the \f[C]setspace\f[] package)
1299+.B \f[C]controls\f[]
1300+show controls in reveal.js slide shows
12451301.RS
12461302.RE
12471303.TP
1248−.B \f[C]fontfamily\f[]
1249−font package to use for LaTeX documents (with pdflatex): TeXLive has
1250−\f[C]bookman\f[] (Bookman), \f[C]utopia\f[] or \f[C]fourier\f[]
1251−(Utopia), \f[C]fouriernc\f[] (New Century Schoolbook), \f[C]times\f[] or
1252−\f[C]txfonts\f[] (Times), \f[C]mathpazo\f[] or \f[C]pxfonts\f[] or
1253−\f[C]mathpple\f[] (Palatino), \f[C]libertine\f[] (Linux Libertine),
1254−\f[C]arev\f[] (Arev Sans), and the default \f[C]lmodern\f[], among
1255−others.
1304+.B \f[C]progress\f[]
1305+show progress bar in reveal.js slide shows
12561306.RS
12571307.RE
1308+.SS Variables for LaTeX
12581309.TP
1259−.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[]
1260−fonts for LaTeX documents (works only with xelatex and lualatex).
1261−Note that if \f[C]CJKmainfont\f[] is used, the \f[C]xeCJK\f[] package
1262−must be available.
1310+.B \f[C]fontsize\f[]
1311+font size (e.g.
1312+\f[C]10pt\f[], \f[C]12pt\f[]) for LaTeX documents
1313+.RS
1314+.RE
1315+.TP
1316+.B \f[C]documentclass\f[]
1317+document class for LaTeX documents, e.g.
1318+\f[C]article\f[], \f[C]report\f[], \f[C]book\f[], \f[C]memoir\f[]
1319+.RS
1320+.RE
1321+.TP
1322+.B \f[C]classoption\f[]
1323+option for LaTeX document class, e.g.
1324+\f[C]oneside\f[]; may be repeated for multiple options
1325+.RS
1326+.RE
1327+.TP
1328+.B \f[C]geometry\f[]
1329+option for LaTeX \f[C]geometry\f[] package, e.g.
1330+\f[C]margin=1in\f[]; may be repeated for multiple options
12631331.RS
12641332.RE
12651333.TP
1266−.B \f[C]colortheme\f[]
1267−colortheme for LaTeX beamer documents
1334+.B \f[C]linestretch\f[]
1335+adjusts line spacing in LaTeX documents using the \f[C]setspace\f[]
1336+package, e.g.
1337+\f[C]1.25\f[], \f[C]1.5\f[]
12681338.RS
12691339.RE
12701340.TP
1271−.B \f[C]fonttheme\f[]
1272−fonttheme for LaTeX beamer documents
1341+.B \f[C]fontfamily\f[]
1342+font package for LaTeX documents (with \f[C]pdflatex\f[]): TeX Live
1343+includes many options, documented in the LaTeX Font Catalogue.
1344+The default is Latin Modern.
12731345.RS
12741346.RE
12751347.TP
1276−.B \f[C]linkcolor\f[]
1277−color for internal links in LaTeX documents (\f[C]red\f[],
1278−\f[C]green\f[], \f[C]magenta\f[], \f[C]cyan\f[], \f[C]blue\f[],
1279−\f[C]black\f[])
1348+.B \f[C]fontfamilyoptions\f[]
1349+options for package used as \f[C]fontfamily\f[]: e.g.
1350+\f[C]osf,sc\f[] with \f[C]fontfamily\f[] set to \f[C]mathpazo\f[]
1351+provides Palatino with old\-style figures and true small caps
12801352.RS
12811353.RE
12821354.TP
1283−.B \f[C]toccolor\f[]
1284−color for links in table of contents in LaTeX documents
1355+.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[]
1356+fonts for LaTeX documents (works only with \f[C]xelatex\f[] and
1357+\f[C]lualatex\f[]): takes the name of any system font, using the
1358+\f[C]fontspec\f[] package.
1359+Note that if \f[C]CJKmainfont\f[] is used, the \f[C]xecjk\f[] package
1360+must be available.
12851361.RS
12861362.RE
12871363.TP
1288−.B \f[C]urlcolor\f[]
1289−color for external links in LaTeX documents
1364+.B \f[C]mainfontoptions\f[], \f[C]sansfontoptions\f[], \f[C]monofontoptions\f[], \f[C]mathfontoptions\f[], \f[C]CJKoptions\f[]
1365+options to use with \f[C]mainfont\f[], \f[C]sansfont\f[],
1366+\f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[] in
1367+\f[C]xelatex\f[] and \f[C]lualatex\f[].
1368+Allows for any choices available through \f[C]fontspec\f[], such as the
1369+OpenType features \f[C]Numbers=OldStyle,Numbers=Proportional\f[].
12901370.RS
12911371.RE
12921372.TP
1293−.B \f[C]citecolor\f[]
1294−color for citation links in LaTeX documents
1373+.B \f[C]linkcolor\f[], \f[C]toccolor\f[], \f[C]urlcolor\f[], \f[C]citecolor\f[]
1374+color for internal links, links in table of contents, external links,
1375+and citation links in LaTeX documents, using options available through
1376+\f[C]color\f[] package, e.g.
1377+\f[C]red\f[], \f[C]green\f[], \f[C]magenta\f[], \f[C]cyan\f[],
1378+\f[C]blue\f[], \f[C]black\f[]
12951379.RS
12961380.RE
12971381.TP
@@ -1334,6 +1418,7 @@ bibliography to use for resolving references
13341418bibliography style in LaTeX, when used with \f[C]\-\-natbib\f[]
13351419.RS
13361420.RE
1421+.SS Variables for man pages
13371422.TP
13381423.B \f[C]section\f[]
13391424section number in man pages
@@ -1349,10 +1434,34 @@ header in man pages
13491434footer in man pages
13501435.RS
13511436.RE
1437+.TP
1438+.B \f[C]adjusting\f[]
1439+adjusts text to left (\f[C]l\f[]), right (\f[C]r\f[]), center
1440+(\f[C]c\f[]), or both (\f[C]b\f[]) margins
1441+.RS
1442+.RE
1443+.TP
1444+.B \f[C]hyphenate\f[]
1445+if \f[C]true\f[] (the default), hyphenation will be used
1446+.RS
1447+.RE
1448+.SS Using variables in templates
13521449.PP
1353−Variables may be set at the command line using the
1354−\f[C]\-V/\-\-variable\f[] option.
1355−Variables set in this way override metadata fields with the same name.
1450+Variable names are sequences of alphanumerics, \f[C]\-\f[], and
1451+\f[C]_\f[], starting with a letter.
1452+A variable name surrounded by \f[C]$\f[] signs will be replaced by its
1453+value.
1454+For example, the string \f[C]$title$\f[] in
1455+.IP
1456+.nf
1457+\f[C]
1458+<title>$title$</title>
1459+\f[]
1460+.fi
1461+.PP
1462+will be replaced by the document title.
1463+.PP
1464+To write a literal \f[C]$\f[] in a template, use \f[C]$$\f[].
13561465.PP
13571466Templates may contain conditionals.
13581467The syntax is as follows:
@@ -1407,9 +1516,8 @@ If you use custom templates, you may need to revise them as pandoc
14071516changes.
14081517We recommend tracking the changes in the default templates, and
14091518modifying your custom templates accordingly.
1410−An easy way to do this is to fork the pandoc\-templates repository
1411−(http://github.com/jgm/pandoc\-templates) and merge in changes after
1412−each pandoc release.
1519+An easy way to do this is to fork the pandoc\-templates repository and
1520+merge in changes after each pandoc release.
14131521.SH PANDOC\[aq]S MARKDOWN
14141522.PP
14151523Pandoc understands an extended and slightly revised version of John
@@ -1460,7 +1568,7 @@ Note: in multiline and grid table cells, this is the only way to create
14601568a hard line break, since trailing spaces in the cells are ignored.
14611569.SS Headers
14621570.PP
1463−There are two kinds of headers, Setext and atx.
1571+There are two kinds of headers: Setext and ATX.
14641572.SS Setext\-style headers
14651573.PP
14661574A setext\-style header is a line of text "underlined" with a row of
@@ -1479,9 +1587,9 @@ A\ level\-two\ header
14791587.PP
14801588The header text can contain inline formatting, such as emphasis (see
14811589Inline formatting, below).
1482−.SS Atx\-style headers
1590+.SS ATX\-style headers
14831591.PP
1484−An Atx\-style header consists of one to six \f[C]#\f[] signs and a line
1592+An ATX\-style header consists of one to six \f[C]#\f[] signs and a line
14851593of text, optionally followed by any number of \f[C]#\f[] signs.
14861594The number of \f[C]#\f[] signs at the beginning of the line is the
14871595header level:
@@ -2528,7 +2636,7 @@ Pipe tables look like this:
25282636\f[]
25292637.fi
25302638.PP
2531−The syntax is the same as in PHP markdown extra.
2639+The syntax is identical to PHP Markdown Extra tables.
25322640The beginning and ending pipe characters are optional, but pipes are
25332641required between all columns.
25342642The colons indicate column alignment as shown.
@@ -2837,9 +2945,9 @@ quotes, \f[C]\-\-\-\f[] to em\-dashes, \f[C]\-\-\f[] to en\-dashes, and
28372945Nonbreaking spaces are inserted after certain abbreviations, such as
28382946"Mr."
28392947.PP
2840−Note: if your LaTeX template uses the \f[C]csquotes\f[] package, pandoc
2841−will detect automatically this and use \f[C]\\enquote{...}\f[] for
2842−quoted text.
2948+Note: if your LaTeX template calls for the \f[C]csquotes\f[] package,
2949+pandoc will detect this automatically and use \f[C]\\enquote{...}\f[]
2950+for quoted text.
28432951.SS Inline formatting
28442952.SS Emphasis
28452953.PP
@@ -2984,14 +3092,13 @@ delimiters.
29843092TeX math will be printed in all output formats.
29853093How it is rendered depends on the output format:
29863094.TP
2987−.B Markdown, LaTeX, Org\-Mode, ConTeXt
3095+.B Markdown, LaTeX, Emacs Org mode, ConTeXt
29883096It will appear verbatim between \f[C]$\f[] characters.
29893097.RS
29903098.RE
29913099.TP
29923100.B reStructuredText
2993−It will be rendered using an interpreted text role \f[C]:math:\f[], as
2994−described here
3101+It will be rendered using an interpreted text role \f[C]:math:\f[].
29953102.RS
29963103.RE
29973104.TP
@@ -3026,9 +3133,9 @@ otherwise appear verbatim.
30263133.RS
30273134.RE
30283135.TP
3029−.B Docbook
3136+.B DocBook
30303137If the \f[C]\-\-mathml\f[] flag is used, it will be rendered using
3031−mathml in an \f[C]inlineequation\f[] or \f[C]informalequation\f[] tag.
3138+MathML in an \f[C]inlineequation\f[] or \f[C]informalequation\f[] tag.
30323139Otherwise it will be rendered, if possible, using unicode characters.
30333140.RS
30343141.RE
@@ -3079,8 +3186,8 @@ is at \f[C]/cgi\-bin/mimetex.cgi\f[].
30793186If the \f[C]\-\-gladtex\f[] option is used, TeX formulas will be
30803187enclosed in \f[C]<eq>\f[] tags in the HTML output.
30813188The resulting \f[C]htex\f[] file may then be processed by gladTeX, which
3082−will produce image files for each formula and an \f[C]html\f[] file with
3083−links to these images.
3189+will produce image files for each formula and an HTML file with links to
3190+these images.
30843191So, the procedure is:
30853192.RS 4
30863193.IP
@@ -3360,7 +3467,7 @@ See\ [my\ website].
33603467.SS Internal links
33613468.PP
33623469To link to another section of the same document, use the automatically
3363−generated identifier (see Header identifiers, below).
3470+generated identifier (see Header identifiers).
33643471For example:
33653472.IP
33663473.nf
@@ -3556,18 +3663,49 @@ T}@T{
35563663T}
35573664.TE
35583665.PP
3559−Note that \f[C]\&.bib\f[] can generally be used with both BibTeX and
3560−BibLaTeX files, but you can use \f[C]\&.bibtex\f[] to force BibTeX.
3666+Note that \f[C]\&.bib\f[] can be used with both BibTeX and BibLaTeX
3667+files; use \f[C]\&.bibtex\f[] to force BibTeX.
35613668.PP
35623669Note that \f[C]pandoc\-citeproc\ \-\-bib2json\f[] and
35633670\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce \f[C]\&.json\f[] and
35643671\f[C]\&.yaml\f[] files from any of the supported formats.
35653672.PP
3566−In\-field markup: In bibtex and biblatex databases, pandoc\-citeproc
3567−parses (a subset of) LaTeX markup; in CSL JSON databases, an HTML\-like
3568−markup (specs); and in CSL YAML databases, pandoc markdown.
3569−\f[C]pandoc\-citeproc\ \-j\f[] and \f[C]\-y\f[] interconvert these
3570−markup formats as far as possible.
3673+In\-field markup: In BibTeX and BibLaTeX databases, pandoc\-citeproc
3674+parses a subset of LaTeX markup; in CSL YAML databases, pandoc markdown;
3675+and in CSL JSON databases, an HTML\-like markup:
3676+.TP
3677+.B \f[C]<i>...</i>\f[]
3678+italics
3679+.RS
3680+.RE
3681+.TP
3682+.B \f[C]<b>...</b>\f[]
3683+bold
3684+.RS
3685+.RE
3686+.TP
3687+.B \f[C]<span\ style="font\-variant:small\-caps;">...</span>\f[] or \f[C]<sc>...</sc>\f[]
3688+small capitals
3689+.RS
3690+.RE
3691+.TP
3692+.B \f[C]<sub>...</sub>\f[]
3693+subscript
3694+.RS
3695+.RE
3696+.TP
3697+.B \f[C]<sup>...</sup>\f[]
3698+superscript
3699+.RS
3700+.RE
3701+.TP
3702+.B \f[C]<span\ class="nocase">...</span>\f[]
3703+prevent a phrase from being capitalized as title case
3704+.RS
3705+.RE
3706+.PP
3707+\f[C]pandoc\-citeproc\ \-j\f[] and \f[C]\-y\f[] interconvert the CSL
3708+JSON and CSL YAML formats as far as possible.
35713709.PP
35723710As an alternative to specifying a bibliography file, you can include the
35733711citation data directly in the \f[C]references\f[] field of the
@@ -3608,15 +3746,14 @@ references:
36083746(\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce these from a
36093747bibliography file in one of the supported formats.)
36103748.PP
3749+Citations and references can be formatted using any style supported by
3750+the Citation Style Language, listed in the Zotero Style Repository.
3751+These files are specified using the \f[C]\-\-csl\f[] option or the
3752+\f[C]csl\f[] metadata field.
36113753By default, \f[C]pandoc\-citeproc\f[] will use the Chicago Manual of
3612−Style author\-date format for citations and references.
3613−To use another style, you will need to specify a CSL 1.0 style file in
3614−the \f[C]csl\f[] metadata field.
3615−A repository of CSL styles can be found at
3616−https://github.com/citation\-style\-language/styles.
3617−See also http://zotero.org/styles for easy browsing.
3618−A primer on creating and modifying CSL styles can be found at
3619−http://citationstyles.org/downloads/primer.html.
3754+Style author\-date format.
3755+The CSL project provides further information on finding and editing
3756+styles.
36203757.PP
36213758Citations go inside square brackets and are separated by semicolons.
36223759Each citation must have a key, composed of \[aq]\@\[aq] + the citation
@@ -3629,7 +3766,7 @@ Here are some examples:
36293766.IP
36303767.nf
36313768\f[C]
3632−Blah\ blah\ [see\ \@doe99,\ pp.\ 33\-35;\ also\ \@smith04,\ ch.\ 1].
3769+Blah\ blah\ [see\ \@doe99,\ pp.\ 33\-35;\ also\ \@smith04,\ chap.\ 1].
36333770
36343771Blah\ blah\ [\@doe99,\ pp.\ 33\-35,\ 38\-39\ and\ *passim*].
36353772
@@ -3637,6 +3774,25 @@ Blah\ blah\ [\@smith04;\ \@doe99].
36373774\f[]
36383775.fi
36393776.PP
3777+\f[C]pandoc\-citeproc\f[] detects locator terms in the CSL locale files.
3778+Either abbreviated or unabbreviated forms are accepted.
3779+In the \f[C]en\-US\f[] locale, locator terms can be written in either
3780+singular or plural forms, as \f[C]book\f[], \f[C]bk.\f[]/\f[C]bks.\f[];
3781+\f[C]chapter\f[], \f[C]chap.\f[]/\f[C]chaps.\f[]; \f[C]column\f[],
3782+\f[C]col.\f[]/\f[C]cols.\f[]; \f[C]figure\f[],
3783+\f[C]fig.\f[]/\f[C]figs.\f[]; \f[C]folio\f[],
3784+\f[C]fol.\f[]/\f[C]fols.\f[]; \f[C]number\f[],
3785+\f[C]no.\f[]/\f[C]nos.\f[]; \f[C]line\f[], \f[C]l.\f[]/\f[C]ll.\f[];
3786+\f[C]note\f[], \f[C]n.\f[]/\f[C]nn.\f[]; \f[C]opus\f[],
3787+\f[C]op.\f[]/\f[C]opp.\f[]; \f[C]page\f[], \f[C]p.\f[]/\f[C]pp.\f[];
3788+\f[C]paragraph\f[], \f[C]para.\f[]/\f[C]paras.\f[]; \f[C]part\f[],
3789+\f[C]pt.\f[]/\f[C]pts.\f[]; \f[C]section\f[],
3790+\f[C]sec.\f[]/\f[C]secs.\f[]; \f[C]sub\ verbo\f[],
3791+\f[C]s.v.\f[]/\f[C]s.vv.\f[]; \f[C]verse\f[], \f[C]v.\f[]/\f[C]vv.\f[];
3792+\f[C]volume\f[], \f[C]vol.\f[]/\f[C]vols.\f[]; \f[C]¶\f[]/\f[C]¶¶\f[];
3793+\f[C]§\f[]/\f[C]§§\f[].
3794+If no locator term is used, "page" is assumed.
3795+.PP
36403796A minus sign (\f[C]\-\f[]) before the \f[C]\@\f[] will suppress mention
36413797of the author in the citation.
36423798This can be useful when the author is already mentioned in the text:
@@ -3692,8 +3848,8 @@ In this example, the document will contain a citation for \f[C]item3\f[]
36923848only, but the bibliography will contain entries for \f[C]item1\f[],
36933849\f[C]item2\f[], and \f[C]item3\f[].
36943850.PP
3695−For LaTeX or PDF output, you can also use NatBib or BibLaTeX to render
3696−bibliography.
3851+For LaTeX or PDF output, you can also use \f[C]natbib\f[] or
3852+\f[C]biblatex\f[] to render bibliography.
36973853In order to do so, specify bibliography files as outlined above, and add
36983854\f[C]\-\-natbib\f[] or \f[C]\-\-biblatex\f[] argument to \f[C]pandoc\f[]
36993855invocation.
@@ -3764,7 +3920,7 @@ Parses PHP Markdown Extra abbreviation keys, like
37643920.IP
37653921.nf
37663922\f[C]
3767−*[HTML]:\ Hyper\ Text\ Markup\ Language
3923+*[HTML]:\ Hypertext\ Markup\ Language
37683924\f[]
37693925.fi
37703926.PP
@@ -3794,7 +3950,8 @@ the header but before any trailing \f[C]#\f[]s in an ATX header).
37943950.SS Extension: \f[C]compact_definition_lists\f[]
37953951.PP
37963952Activates the definition list syntax of pandoc 1.12.x and earlier.
3797−This syntax differs from the one described above in several respects:
3953+This syntax differs from the one described above under Definition lists
3954+in several respects:
37983955.IP \[bu] 2
37993956No blank line is required between consecutive items of the definition
38003957list.
@@ -3819,7 +3976,7 @@ variants are supported:
38193976.RS
38203977.RE
38213978.TP
3822−.B \f[C]markdown_github\f[] (GitHub\-flavored Markdown)
3979+.B \f[C]markdown_github\f[] (GitHub\-Flavored Markdown)
38233980\f[C]pipe_tables\f[], \f[C]raw_html\f[],
38243981\f[C]tex_math_single_backslash\f[], \f[C]fenced_code_blocks\f[],
38253982\f[C]auto_identifiers\f[], \f[C]ascii_identifiers\f[],
@@ -3862,7 +4019,7 @@ You can use Pandoc to produce an HTML + javascript slide presentation
38624019that can be viewed via a web browser.
38634020There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
38644021reveal.js.
3865−You can also produce a PDF slide show using LaTeX beamer.
4022+You can also produce a PDF slide show using LaTeX \f[C]beamer\f[].
38664023.PP
38674024Here\[aq]s the markdown source for a simple slide show,
38684025\f[C]habits.txt\f[]:
@@ -4053,7 +4210,7 @@ pandoc\ \-t\ beamer\ habits.txt\ \-V\ theme:Warsaw\ \-o\ habits.pdf
40534210Note that header attributes will turn into slide attributes (on a
40544211\f[C]<div>\f[] or \f[C]<section>\f[]) in HTML slide formats, allowing
40554212you to style individual slides.
4056−In Beamer, the only header attribute that affects slides is the
4213+In beamer, the only header attribute that affects slides is the
40574214\f[C]allowframebreaks\f[] class, which sets the
40584215\f[C]allowframebreaks\f[] option, causing multiple slides to be created
40594216if the content overfills the frame.
@@ -4152,7 +4309,7 @@ Valid values for \f[C]type\f[] are \f[C]main\f[], \f[C]subtitle\f[],
41524309.B \f[C]creator\f[]
41534310Either a string value, or an object with fields \f[C]role\f[],
41544311\f[C]file\-as\f[], and \f[C]text\f[], or a list of such objects.
4155−Valid values for \f[C]role\f[] are marc relators, but pandoc will
4312+Valid values for \f[C]role\f[] are MARC relators, but pandoc will
41564313attempt to translate the human\-readable versions (like "author" and
41574314"editor") to the appropriate marc relators.
41584315.RS
@@ -4170,8 +4327,8 @@ common date formats.
41704327.RS
41714328.RE
41724329.TP
4173−.B \f[C]language\f[]
4174−A string value in RFC5646 format.
4330+.B \f[C]lang\f[] (or legacy: \f[C]language\f[])
4331+A string value in BCP 47 format.
41754332Pandoc will default to the local language if nothing is specified.
41764333.RS
41774334.RE
@@ -4223,7 +4380,8 @@ A string value (path to CSS stylesheet).
42234380.TP
42244381.B \f[C]page\-progression\-direction\f[]
42254382Either \f[C]ltr\f[] or \f[C]rtl\f[].
4226−Specifies the \f[C]page\-progression\-direction\f[] spine attribute.
4383+Specifies the \f[C]page\-progression\-direction\f[] attribute for the
4384+\f[C]spine\f[] element.
42274385.RS
42284386.RE
42294387.SH LITERATE HASKELL SUPPORT
@@ -4239,7 +4397,7 @@ In markdown input, "bird track" sections will be parsed as Haskell code
42394397rather than block quotations.
42404398Text between \f[C]\\begin{code}\f[] and \f[C]\\end{code}\f[] will also
42414399be treated as Haskell code.
4242−For atx\-style headers the character \[aq]=\[aq] will be used instead of
4400+For ATX\-style headers the character \[aq]=\[aq] will be used instead of
42434401\[aq]#\[aq].
42444402.IP \[bu] 2
42454403In markdown output, code blocks with classes \f[C]haskell\f[] and
@@ -4247,7 +4405,7 @@ In markdown output, code blocks with classes \f[C]haskell\f[] and
42474405quotations will be indented one space, so they will not be treated as
42484406Haskell code.
42494407In addition, headers will be rendered setext\-style (with underlines)
4250−rather than atx\-style (with \[aq]#\[aq] characters).
4408+rather than ATX\-style (with \[aq]#\[aq] characters).
42514409(This is because ghc treats \[aq]#\[aq] characters in column 1 as
42524410introducing line numbers.)
42534411.IP \[bu] 2
@@ -4289,10 +4447,8 @@ and pasted as literate Haskell source.
42894447.PP
42904448Pandoc will automatically highlight syntax in fenced code blocks that
42914449are marked with a language name.
4292−(See Extension: \f[C]inline_code_attributes\f[] and Extension:
4293−\f[C]fenced_code_attributes\f[], above.) The Haskell library
4294−highlighting\-kate is used for highlighting, which works in HTML, Docx,
4295−and LaTeX/PDF output.
4450+The Haskell library highlighting\-kate is used for highlighting, which
4451+works in HTML, Docx, and LaTeX/PDF output.
42964452The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
42974453option.
42984454The default color scheme is \f[C]pygments\f[], which imitates the
@@ -4350,7 +4506,7 @@ Calvert, Eric Kow, Eric Seidel, Florian Eitel, François Gannaz, Freiric
43504506Barral, Fyodor Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov,
43514507Grégory Bataille, Greg Rundlett, gwern, Gwern Branwen, Hans\-Peter
43524508Deifel, Henry de Valence, Ilya V.
4353−Portnov, infinity0x, Jaime Marquínez Ferrándiz, James Aspnes, Jamie F.
4509+Portnov, infinity0x, Jaime Marquínez Ferrándiz, James Aspnes, Jamie F.
43544510Olson, Jan Larres, Jason Ronallo, Jeff Arnold, Jeff Runningen, Jens
43554511Petersen, Jérémy Bobbio, Jesse Rosenthal, J.
43564512Lewis Muir, Joe Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan