@@ -9,22 +9,24 @@ pandoc - general markup converter
10Pandoc is a Haskell library for converting from one markup format to
10Pandoc is a Haskell library for converting from one markup format to
11another, and a command\-line tool that uses this library.
11another, and a command\-line tool that uses this library.
12−It can read Markdown, CommonMark, and (subsets of) Textile,
12+It can read Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
13+Markdown, and (subsets of) Textile, reStructuredText, HTML, LaTeX,
13−reStructuredText, HTML, LaTeX, MediaWiki markup, TWiki markup, Haddock
14+MediaWiki markup, TWiki markup, Haddock markup, OPML, Emacs Org mode,
14−markup, OPML, Emacs Org\-mode, DocBook, txt2tags, EPUB, ODT and Word
15+DocBook, txt2tags, EPUB, ODT and Word docx; and it can write plain text,
15−docx; and it can write plain text, Markdown, reStructuredText, XHTML,
16+Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored Markdown,
16−HTML 5, LaTeX (including beamer slide shows), ConTeXt, RTF, OPML,
17+reStructuredText, XHTML, HTML5, LaTeX (including \f[C]beamer\f[] slide
17−DocBook, OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup,
18+shows), ConTeXt, RTF, OPML, DocBook, OpenDocument, ODT, Word docx, GNU
18−DokuWiki markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile,
19+Texinfo, MediaWiki markup, DokuWiki markup, Haddock markup, EPUB (v2 or
19−groff man pages, Emacs Org\-Mode, AsciiDoc, InDesign ICML, and Slidy,
20+v3), FictionBook2, Textile, groff man pages, Emacs Org mode, AsciiDoc,
20−Slideous, DZSlides, reveal.js or S5 HTML slide shows.
21+InDesign ICML, and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide
21It can also produce PDF output on systems where LaTeX is installed.
23It can also produce PDF output on systems where LaTeX is installed.
23Pandoc\[aq]s enhanced version of markdown includes syntax for footnotes,
25Pandoc\[aq]s enhanced version of markdown includes syntax for footnotes,
24tables, flexible ordered lists, definition lists, fenced code blocks,
26tables, flexible ordered lists, definition lists, fenced code blocks,
25−superscript, subscript, strikeout, title blocks, automatic tables of
27+superscripts and subscripts, strikeout, metadata blocks, automatic
26−contents, embedded LaTeX math, citations, and markdown inside HTML block
28+tables of contents, embedded LaTeX math, citations, and markdown inside
27−elements.
29+HTML block elements.
28(These enhancements, described below under Pandoc\[aq]s markdown, can be
30(These enhancements, described below under Pandoc\[aq]s markdown, can be
29disabled using the \f[C]markdown_strict\f[] input or output format.)
31disabled using the \f[C]markdown_strict\f[] input or output format.)
@@ -105,7 +107,7 @@ pandoc\ \-f\ markdown\ \-t\ latex\ hello.txt
108−To convert \f[C]hello.html\f[] from html to markdown:
110+To convert \f[C]hello.html\f[] from HTML to markdown:
@@ -156,14 +158,9 @@ included in the document header, which will only be included if you use
156the \f[C]\-s/\-\-standalone\f[] option.
158the \f[C]\-s/\-\-standalone\f[] option.
157.SS Creating a PDF
159.SS Creating a PDF
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[]
164extension.
162extension.
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:
@@ -173,15 +170,27 @@ pandoc\ test.txt\ \-o\ test.pdf
174Production of a PDF requires that a LaTeX engine be installed (see
171Production of a PDF requires that a LaTeX engine be installed (see
175\f[C]\-\-latex\-engine\f[], below), and assumes that the following LaTeX
172\f[C]\-\-latex\-engine\f[], below), and assumes that the following LaTeX
176−packages are available: \f[C]amssymb\f[], \f[C]amsmath\f[],
173+packages are available: \f[C]amsfonts\f[], \f[C]amsmath\f[],
177−\f[C]ifxetex\f[], \f[C]ifluatex\f[], \f[C]listings\f[] (if the
174+\f[C]lm\f[], \f[C]ifxetex\f[], \f[C]ifluatex\f[], \f[C]eurosym\f[],
178−\f[C]\-\-listings\f[] option is used), \f[C]fancyvrb\f[],
175+\f[C]listings\f[] (if the \f[C]\-\-listings\f[] option is used),
179−\f[C]longtable\f[], \f[C]booktabs\f[], \f[C]url\f[], \f[C]graphicx\f[]
176+\f[C]fancyvrb\f[], \f[C]longtable\f[], \f[C]booktabs\f[], \f[C]url\f[],
180−and \f[C]grffile\f[] (if the document contains images),
177+\f[C]graphicx\f[] and \f[C]grffile\f[] (if the document contains
181−\f[C]hyperref\f[], \f[C]ulem\f[], \f[C]babel\f[] (if the \f[C]lang\f[]
178+images), \f[C]color\f[], \f[C]hyperref\f[], \f[C]ulem\f[],
182−variable is set), \f[C]fontspec\f[] (if \f[C]xelatex\f[] or
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
183−\f[C]lualatex\f[] is used as the LaTeX engine), \f[C]xltxtra\f[] and
182+The use of \f[C]xelatex\f[] or \f[C]lualatex\f[] as the LaTeX engine
184−\f[C]xunicode\f[] (if \f[C]xelatex\f[] is used).
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.
193+PDF output can be controlled using variables for LaTeX.
185.SS \f[C]hsmarkdown\f[]
194.SS \f[C]hsmarkdown\f[]
187A user who wants a drop\-in replacement for \f[C]Markdown.pl\f[] may
196A 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
191behave as if invoked with
200behave as if invoked with
192\f[C]\-f\ markdown_strict\ \-\-email\-obfuscation=references\f[], and
201\f[C]\-f\ markdown_strict\ \-\-email\-obfuscation=references\f[], and
193all command\-line options will be treated as regular arguments.
202all command\-line options will be treated as regular arguments.
194−However, this approach does not work under Cygwin, due to problems with
203+This approach does not work under Cygwin, due to problems with its
195−its simulation of symbolic links.
204+simulation of symbolic links.
196.SH OPTIONS
205.SH OPTIONS
197.SS General options
206.SS General options
@@ -201,13 +210,13 @@ Specify input format.
201\f[I]FORMAT\f[] can be \f[C]native\f[] (native Haskell), \f[C]json\f[]
210\f[I]FORMAT\f[] can be \f[C]native\f[] (native Haskell), \f[C]json\f[]
202(JSON version of native AST), \f[C]markdown\f[] (pandoc\[aq]s extended
211(JSON version of native AST), \f[C]markdown\f[] (pandoc\[aq]s extended
203markdown), \f[C]markdown_strict\f[] (original unextended markdown),
212markdown), \f[C]markdown_strict\f[] (original unextended markdown),
204−\f[C]markdown_phpextra\f[] (PHP Markdown Extra extended markdown),
213+\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
205−\f[C]markdown_github\f[] (github extended markdown), \f[C]commonmark\f[]
214+\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
206−(CommonMark markdown), \f[C]textile\f[] (Textile), \f[C]rst\f[]
215+\f[C]commonmark\f[] (CommonMark markdown), \f[C]textile\f[] (Textile),
207−(reStructuredText), \f[C]html\f[] (HTML), \f[C]docbook\f[] (DocBook),
216+\f[C]rst\f[] (reStructuredText), \f[C]html\f[] (HTML), \f[C]docbook\f[]
208−\f[C]t2t\f[] (txt2tags), \f[C]docx\f[] (docx), \f[C]odt\f[] (ODT),
217+(DocBook), \f[C]t2t\f[] (txt2tags), \f[C]docx\f[] (docx), \f[C]odt\f[]
209−\f[C]epub\f[] (EPUB), \f[C]opml\f[] (OPML), \f[C]org\f[] (Emacs
218+(ODT), \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
219+Org mode), \f[C]mediawiki\f[] (MediaWiki markup), \f[C]twiki\f[] (TWiki
211markup), \f[C]haddock\f[] (Haddock markup), or \f[C]latex\f[] (LaTeX).
220markup), \f[C]haddock\f[] (Haddock markup), or \f[C]latex\f[] (LaTeX).
212If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],
221If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],
213\f[C]latex\f[], or \f[C]html\f[], the input will be treated as literate
222\f[C]latex\f[], or \f[C]html\f[], the input will be treated as literate
@@ -230,25 +239,25 @@ Specify output format.
230(JSON version of native AST), \f[C]plain\f[] (plain text),
239(JSON version of native AST), \f[C]plain\f[] (plain text),
231\f[C]markdown\f[] (pandoc\[aq]s extended markdown),
240\f[C]markdown\f[] (pandoc\[aq]s extended markdown),
232\f[C]markdown_strict\f[] (original unextended markdown),
241\f[C]markdown_strict\f[] (original unextended markdown),
233−\f[C]markdown_phpextra\f[] (PHP Markdown extra extended markdown),
242+\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
234−\f[C]markdown_github\f[] (github extended markdown), \f[C]commonmark\f[]
243+\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
235−(CommonMark markdown), \f[C]rst\f[] (reStructuredText), \f[C]html\f[]
244+\f[C]commonmark\f[] (CommonMark markdown), \f[C]rst\f[]
236−(XHTML 1), \f[C]html5\f[] (HTML 5), \f[C]latex\f[] (LaTeX),
245+(reStructuredText), \f[C]html\f[] (XHTML), \f[C]html5\f[] (HTML5),
237−\f[C]beamer\f[] (LaTeX beamer slide show), \f[C]context\f[] (ConTeXt),
246+\f[C]latex\f[] (LaTeX), \f[C]beamer\f[] (LaTeX beamer slide show),
238−\f[C]man\f[] (groff man), \f[C]mediawiki\f[] (MediaWiki markup),
247+\f[C]context\f[] (ConTeXt), \f[C]man\f[] (groff man), \f[C]mediawiki\f[]
239−\f[C]dokuwiki\f[] (DokuWiki markup), \f[C]textile\f[] (Textile),
248+(MediaWiki markup), \f[C]dokuwiki\f[] (DokuWiki markup),
249+\f[C]textile\f[] (Textile), \f[C]org\f[] (Emacs Org mode),
240−\f[C]org\f[] (Emacs Org\-Mode), \f[C]texinfo\f[] (GNU Texinfo),
250+\f[C]texinfo\f[] (GNU Texinfo), \f[C]opml\f[] (OPML), \f[C]docbook\f[]
241−\f[C]opml\f[] (OPML), \f[C]docbook\f[] (DocBook), \f[C]opendocument\f[]
251+(DocBook), \f[C]opendocument\f[] (OpenDocument), \f[C]odt\f[]
242−(OpenDocument), \f[C]odt\f[] (OpenOffice text document), \f[C]docx\f[]
252+(OpenOffice text document), \f[C]docx\f[] (Word docx), \f[C]haddock\f[]
243−(Word docx), \f[C]haddock\f[] (Haddock markup), \f[C]rtf\f[] (rich text
253+(Haddock markup), \f[C]rtf\f[] (rich text format), \f[C]epub\f[] (EPUB
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),
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),
246−\f[C]icml\f[] (InDesign ICML), \f[C]slidy\f[] (Slidy HTML and javascript
256+\f[C]slidy\f[] (Slidy HTML and javascript slide show), \f[C]slideous\f[]
247−slide show), \f[C]slideous\f[] (Slideous HTML and javascript slide
257+(Slideous HTML and javascript slide show), \f[C]dzslides\f[] (DZSlides
248−show), \f[C]dzslides\f[] (DZSlides HTML5 + javascript slide show),
258+HTML5 + javascript slide show), \f[C]revealjs\f[] (reveal.js HTML5 +
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
259+javascript slide show), \f[C]s5\f[] (S5 HTML and javascript slide show),
251−(see Custom writers, below).
260+or the path of a custom lua writer (see Custom writers, below).
252Note that \f[C]odt\f[], \f[C]epub\f[], and \f[C]epub3\f[] output will
261Note that \f[C]odt\f[], \f[C]epub\f[], and \f[C]epub3\f[] output will
253not be directed to \f[I]stdout\f[]; an output filename must be specified
262not be directed to \f[I]stdout\f[]; an output filename must be specified
254using the \f[C]\-o/\-\-output\f[] option.
263using 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[].
274Specify the user data directory to search for pandoc data files.
283Specify the user data directory to search for pandoc data files.
275If this option is not specified, the default user data directory will be
284If this option is not specified, the default user data directory will be
277−This is
286+This is, in Unix:
@@ -283,7 +292,7 @@ $HOME/.pandoc
286−in unix,
295+in Windows XP:
@@ -291,7 +300,7 @@ C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\pandoc
294−in Windows XP, and
303+and in Windows Vista or later:
@@ -299,18 +308,17 @@ C:\\Users\\USERNAME\\AppData\\Roaming\\pandoc
303−(You can find the default user data directory on your system by looking
311+You can find the default user data directory on your system by looking
304−at the output of \f[C]pandoc\ \-\-version\f[].) A
312+at the output of \f[C]pandoc\ \-\-version\f[].
305−\f[C]reference.odt\f[], \f[C]reference.docx\f[], \f[C]default.csl\f[],
313+A \f[C]reference.odt\f[], \f[C]reference.docx\f[], \f[C]epub.css\f[],
306−\f[C]epub.css\f[], \f[C]templates\f[], \f[C]slidy\f[],
314+\f[C]templates\f[], \f[C]slidy\f[], \f[C]slideous\f[], or \f[C]s5\f[]
307−\f[C]slideous\f[], or \f[C]s5\f[] directory placed in this directory
308−will override pandoc\[aq]s normal defaults.
315+directory placed in this directory will override pandoc\[aq]s normal
311−.B \f[C]\-\-bash\-completiion\f[]
319+.B \f[C]\-\-bash\-completion\f[]
312Generate a bash completion script.
320Generate 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
314\f[C]\&.bashrc\f[]:
322\f[C]\&.bashrc\f[]:
@@ -426,8 +434,6 @@ Filters may be written in any language.
426writing filters in Haskell.
434writing filters in Haskell.
427Those who would prefer to write filters in python can use the module
435Those who would prefer to write filters in python can use the module
428\f[C]pandocfilters\f[], installable from PyPI.
436\f[C]pandocfilters\f[], installable from PyPI.
429−See http://github.com/jgm/pandocfilters for the module and several
431There are also pandoc filter libraries in PHP, perl, and
437There are also pandoc filter libraries in PHP, perl, and
432javascript/node.js.
438javascript/node.js.
@@ -473,7 +479,7 @@ Specify the number of spaces per tab (default is 4).
474.B \f[C]\-\-track\-changes=accept\f[]|\f[C]reject\f[]|\f[C]all\f[]
480.B \f[C]\-\-track\-changes=accept\f[]|\f[C]reject\f[]|\f[C]all\f[]
475Specifies what to do with insertions and deletions produced by the MS
481Specifies what to do with insertions and deletions produced by the MS
476−Word "track\-changes" feature.
482+Word "Track Changes" feature.
477\f[C]accept\f[] (the default), inserts all insertions, and ignores all
483\f[C]accept\f[] (the default), inserts all insertions, and ignores all
478deletions.
484deletions.
479\f[C]reject\f[] inserts all deletions and ignores insertions.
485\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[],
506.B \f[C]\-\-template=\f[]\f[I]FILE\f[]
512.B \f[C]\-\-template=\f[]\f[I]FILE\f[]
507Use \f[I]FILE\f[] as a custom template for the generated document.
513Use \f[I]FILE\f[] as a custom template for the generated document.
508Implies \f[C]\-\-standalone\f[].
514Implies \f[C]\-\-standalone\f[].
509−See Templates below for a description of template syntax.
515+See Templates, below, for a description of template syntax.
510If no extension is specified, an extension corresponding to the writer
516If no extension is specified, an extension corresponding to the writer
511will be added, so that \f[C]\-\-template=special\f[] looks for
517will be added, so that \f[C]\-\-template=special\f[] looks for
512\f[C]special.html\f[] for HTML output.
518\f[C]special.html\f[] for HTML output.
@@ -674,7 +680,7 @@ By default inline links are used.
676.B \f[C]\-\-atx\-headers\f[]
682.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.
678The default is to use setext\-style headers for levels 1\-2, and then
684The default is to use setext\-style headers for levels 1\-2, and then
679ATX headers.
685ATX headers.
@@ -683,8 +689,8 @@ ATX headers.
683.B \f[C]\-\-chapters\f[]
689.B \f[C]\-\-chapters\f[]
684Treat top\-level headers as chapters in LaTeX, ConTeXt, and DocBook
690Treat top\-level headers as chapters in LaTeX, ConTeXt, and DocBook
686−When the LaTeX template uses the report, book, or memoir class, this
692+When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
687−option is implied.
693+or \f[C]memoir\f[], this option is implied.
688If \f[C]beamer\f[] is the output format, top\-level headers will become
694If \f[C]beamer\f[] is the output format, top\-level headers will become
689\f[C]\\part{..}\f[].
695\f[C]\\part{..}\f[].
@@ -716,8 +722,8 @@ Implies \f[C]\-\-number\-sections\f[].
716Do not convert quotation marks, apostrophes, and dashes to the TeX
722Do not convert quotation marks, apostrophes, and dashes to the TeX
717ligatures when writing LaTeX or ConTeXt.
723ligatures when writing LaTeX or ConTeXt.
718Instead, just use literal unicode characters.
724Instead, just use literal unicode characters.
719−This is needed for using advanced OpenType features with XeLaTeX and
725+This is needed for using advanced OpenType features with
720−LuaLaTeX.
726+\f[C]xelatex\f[] and \f[C]lualatex\f[].
721Note: normally \f[C]\-\-smart\f[] is selected automatically for LaTeX
727Note: normally \f[C]\-\-smart\f[] is selected automatically for LaTeX
722and ConTeXt output, but it must be specified explicitly if
728and ConTeXt output, but it must be specified explicitly if
723\f[C]\-\-no\-tex\-ligatures\f[] is selected.
729\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
730.B \f[C]\-\-listings\f[]
736.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
@@ -746,7 +752,7 @@ Headers above this level in the hierarchy are used to divide the slide
746show into sections; headers below this level create subheads within a
752show into sections; headers below this level create subheads within a
748The default is to set the slide level based on the contents of the
754The 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.
@@ -846,8 +852,7 @@ below).
847.B \f[C]\-\-epub\-metadata=\f[]\f[I]FILE\f[]
853.B \f[C]\-\-epub\-metadata=\f[]\f[I]FILE\f[]
848Look in the specified XML file for metadata for the EPUB.
854Look in the specified XML file for metadata for the EPUB.
849−The file should contain a series of Dublin Core elements, as documented
855+The file should contain a series of Dublin Core elements.
850−at http://dublincore.org/documents/dces/.
851For example:
856For example:
@@ -975,20 +980,20 @@ only relevant with \f[C]pandoc\-citeproc\f[].
977.B \f[C]\-\-natbib\f[]
982.B \f[C]\-\-natbib\f[]
978−Use natbib for citations in LaTeX output.
983+Use \f[C]natbib\f[] for citations in LaTeX output.
979This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
984This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
980with PDF output.
985with PDF output.
981It is intended for use in producing a LaTeX file that can be processed
986It is intended for use in producing a LaTeX file that can be processed
982−with pdflatex and bibtex.
987+with \f[C]bibtex\f[].
986.B \f[C]\-\-biblatex\f[]
991.B \f[C]\-\-biblatex\f[]
987−Use biblatex for citations in LaTeX output.
992+Use \f[C]biblatex\f[] for citations in LaTeX output.
988This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
993This option is not for use with the \f[C]pandoc\-citeproc\f[] filter or
989with PDF output.
994with PDF output.
990It is intended for use in producing a LaTeX file that can be processed
995It 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[].
994.SS Math rendering in HTML
999.SS Math rendering in HTML
@@ -1116,42 +1121,55 @@ To see the default template that is used, just type
1119−pandoc\ \-D\ FORMAT
1124+pandoc\ \-D\ *FORMAT*
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.
1124A custom template can be specified using the \f[C]\-\-template\f[]
1129A custom template can be specified using the \f[C]\-\-template\f[]
1126You can also override the system default templates for a given output
1131You can also override the system default templates for a given output
1127−format \f[C]FORMAT\f[] by putting a file
1132+format \f[I]FORMAT\f[] by putting a file
1128−\f[C]templates/default.FORMAT\f[] in the user data directory (see
1133+\f[C]templates/default.*FORMAT*\f[] in the user data directory (see
1129\f[C]\-\-data\-dir\f[], above).
1134\f[C]\-\-data\-dir\f[], above).
1130\f[I]Exceptions:\f[] For \f[C]odt\f[] output, customize the
1135\f[I]Exceptions:\f[] For \f[C]odt\f[] output, customize the
1131\f[C]default.opendocument\f[] template.
1136\f[C]default.opendocument\f[] template.
1132For \f[C]pdf\f[] output, customize the \f[C]default.latex\f[] template.
1137For \f[C]pdf\f[] output, customize the \f[C]default.latex\f[] template.
1134−Templates may contain \f[I]variables\f[].
1139+Templates contain \f[I]variables\f[], which allow for the inclusion of
1135−Variable names are sequences of alphanumerics, \f[C]\-\f[], and
1140+arbitrary information at any point in the file.
1136−\f[C]_\f[], starting with a letter.
1141+Variables may be set within the document using YAML metadata blocks.
1137−A variable name surrounded by \f[C]$\f[] signs will be replaced by its
1142+They may also be set at the command line using the
1138−value.
1143+\f[C]\-V/\-\-variable\f[] option: variables set in this way override
1139−For example, the string \f[C]$title$\f[] in
1144+metadata fields with the same name.
1145+.SS Variables set by pandoc
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:
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:
1143−<title>$title$</title>
1160+\-\-\-
1147−will be replaced by the document title.
1168+.TP
1148−.PP
1169+.B \f[C]abstract\f[]
1149−To write a literal \f[C]$\f[] in a template, use \f[C]$$\f[].
1170+allows for specification of document summary in LaTeX and Word docx
1151−Some variables are set automatically by pandoc.
1172+.RE
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:
1156.B \f[C]header\-includes\f[]
1174.B \f[C]header\-includes\f[]
1157contents specified by \f[C]\-H/\-\-include\-in\-header\f[] (may have
1175contents specified by \f[C]\-H/\-\-include\-in\-header\f[] (may have
@@ -1181,12 +1199,50 @@ multiple values)
1181body of document
1199body of document
1202+.SS Language variables
1185.B \f[C]lang\f[]
1204.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
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).
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.
1224+the base direction of the document, either \f[C]rtl\f[]
1225+(right\-to\-left) or \f[C]ltr\f[] (left\-to\-right).
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
1232+This may not always be necessary if the final renderer (e.g.
1233+the browser, when generating HTML) supports the Unicode Bidirectional
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.
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[]).
1244+.SS Variables for slides
1190.B \f[C]slidy\-url\f[]
1246.B \f[C]slidy\-url\f[]
1191base URL for Slidy documents (defaults to
1247base URL for Slidy documents (defaults to
1192\f[C]http://www.w3.org/Talks/Tools/Slidy2\f[])
1248\f[C]http://www.w3.org/Talks/Tools/Slidy2\f[])
@@ -1214,84 +1270,112 @@ reveal.js or LaTeX beamer theme
1216.B \f[C]transition\f[]
1272.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[]
1221−.B \f[C]fontsize\f[]
1278+.B \f[C]center\f[]
1222−font size (10pt, 11pt, 12pt) for LaTeX documents
1279+enables vertical centering of slides in reveal.js
1226−.B \f[C]documentclass\f[]
1283+.B \f[C]maxScale\f[]
1227−document class for LaTeX documents
1284+bounds for smallest/largest possible content scale in reveal.js
1231−.B \f[C]classoption\f[]
1289+.B \f[C]slideNumber\f[]
1232−option for LaTeX documentclass, e.g.
1290+enables display of the page number of the current slide in reveal.js
1233−\f[C]oneside\f[]; may be repeated for multiple options
1237−.B \f[C]geometry\f[]
1294+.B \f[C]colortheme\f[], \f[C]fonttheme\f[], \f[C]innertheme\f[], \f[C]outertheme\f[]
1238−options for LaTeX \f[C]geometry\f[] class, e.g.
1295+themes for LaTeX \f[C]beamer\f[] documents
1239−\f[C]margin=1in\f[]; may be repeated for multiple options
1243−.B \f[C]linestretch\f[]
1299+.B \f[C]controls\f[]
1244−adjusts line spacing (requires the \f[C]setspace\f[] package)
1300+show controls in reveal.js slide shows
1248−.B \f[C]fontfamily\f[]
1304+.B \f[C]progress\f[]
1249−font package to use for LaTeX documents (with pdflatex): TeXLive has
1305+show progress bar in reveal.js slide shows
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
1308+.SS Variables for LaTeX
1259−.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[]
1310+.B \f[C]fontsize\f[]
1260−fonts for LaTeX documents (works only with xelatex and lualatex).
1311+font size (e.g.
1261−Note that if \f[C]CJKmainfont\f[] is used, the \f[C]xeCJK\f[] package
1312+\f[C]10pt\f[], \f[C]12pt\f[]) for LaTeX documents
1262−must be available.
1313+.RS
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[]
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
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
1266−.B \f[C]colortheme\f[]
1334+.B \f[C]linestretch\f[]
1267−colortheme for LaTeX beamer documents
1335+adjusts line spacing in LaTeX documents using the \f[C]setspace\f[]
1337+\f[C]1.25\f[], \f[C]1.5\f[]
1271−.B \f[C]fonttheme\f[]
1341+.B \f[C]fontfamily\f[]
1272−fonttheme for LaTeX beamer documents
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.
1276−.B \f[C]linkcolor\f[]
1348+.B \f[C]fontfamilyoptions\f[]
1277−color for internal links in LaTeX documents (\f[C]red\f[],
1349+options for package used as \f[C]fontfamily\f[]: e.g.
1278−\f[C]green\f[], \f[C]magenta\f[], \f[C]cyan\f[], \f[C]blue\f[],
1350+\f[C]osf,sc\f[] with \f[C]fontfamily\f[] set to \f[C]mathpazo\f[]
1279−\f[C]black\f[])
1351+provides Palatino with old\-style figures and true small caps
1283−.B \f[C]toccolor\f[]
1355+.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[]
1284−color for links in table of contents in LaTeX documents
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
1288−.B \f[C]urlcolor\f[]
1364+.B \f[C]mainfontoptions\f[], \f[C]sansfontoptions\f[], \f[C]monofontoptions\f[], \f[C]mathfontoptions\f[], \f[C]CJKoptions\f[]
1289−color for external links in LaTeX documents
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[].
1293−.B \f[C]citecolor\f[]
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,
1294−color for citation links in LaTeX documents
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[]
@@ -1334,6 +1418,7 @@ bibliography to use for resolving references
1334bibliography style in LaTeX, when used with \f[C]\-\-natbib\f[]
1418bibliography style in LaTeX, when used with \f[C]\-\-natbib\f[]
1421+.SS Variables for man pages
1338.B \f[C]section\f[]
1423.B \f[C]section\f[]
1339section number in man pages
1424section number in man pages
@@ -1349,10 +1434,34 @@ header in man pages
1349footer in man pages
1434footer in man pages
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
1444+.B \f[C]hyphenate\f[]
1445+if \f[C]true\f[] (the default), hyphenation will be used
1448+.SS Using variables in templates
1353−Variables may be set at the command line using the
1450+Variable names are sequences of alphanumerics, \f[C]\-\f[], and
1354−\f[C]\-V/\-\-variable\f[] option.
1451+\f[C]_\f[], starting with a letter.
1355−Variables set in this way override metadata fields with the same name.
1452+A variable name surrounded by \f[C]$\f[] signs will be replaced by its
1454+For example, the string \f[C]$title$\f[] in
1458+<title>$title$</title>
1462+will be replaced by the document title.
1464+To write a literal \f[C]$\f[] in a template, use \f[C]$$\f[].
1357Templates may contain conditionals.
1466Templates may contain conditionals.
1358The syntax is as follows:
1467The syntax is as follows:
@@ -1407,9 +1516,8 @@ If you use custom templates, you may need to revise them as pandoc
1408We recommend tracking the changes in the default templates, and
1517We recommend tracking the changes in the default templates, and
1409modifying your custom templates accordingly.
1518modifying your custom templates accordingly.
1410−An easy way to do this is to fork the pandoc\-templates repository
1519+An easy way to do this is to fork the pandoc\-templates repository and
1411−(http://github.com/jgm/pandoc\-templates) and merge in changes after
1412−each pandoc release.
1520+merge in changes after each pandoc release.
1413.SH PANDOC\[aq]S MARKDOWN
1521.SH PANDOC\[aq]S MARKDOWN
1415Pandoc understands an extended and slightly revised version of John
1523Pandoc 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
1460a hard line break, since trailing spaces in the cells are ignored.
1568a hard line break, since trailing spaces in the cells are ignored.
1461.SS Headers
1569.SS Headers
1463−There are two kinds of headers, Setext and atx.
1571+There are two kinds of headers: Setext and ATX.
1464.SS Setext\-style headers
1572.SS Setext\-style headers
1466A setext\-style header is a line of text "underlined" with a row of
1574A setext\-style header is a line of text "underlined" with a row of
@@ -1479,9 +1587,9 @@ A\ level\-two\ header
1480The header text can contain inline formatting, such as emphasis (see
1588The header text can contain inline formatting, such as emphasis (see
1481Inline formatting, below).
1589Inline formatting, below).
1482−.SS Atx\-style headers
1590+.SS ATX\-style headers
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
1485of text, optionally followed by any number of \f[C]#\f[] signs.
1593of text, optionally followed by any number of \f[C]#\f[] signs.
1486The number of \f[C]#\f[] signs at the beginning of the line is the
1594The number of \f[C]#\f[] signs at the beginning of the line is the
1487header level:
1595header level:
@@ -2528,7 +2636,7 @@ Pipe tables look like this:
2531−The syntax is the same as in PHP markdown extra.
2639+The syntax is identical to PHP Markdown Extra tables.
2532The beginning and ending pipe characters are optional, but pipes are
2640The beginning and ending pipe characters are optional, but pipes are
2533required between all columns.
2641required between all columns.
2534The colons indicate column alignment as shown.
2642The colons indicate column alignment as shown.
@@ -2837,9 +2945,9 @@ quotes, \f[C]\-\-\-\f[] to em\-dashes, \f[C]\-\-\f[] to en\-dashes, and
2837Nonbreaking spaces are inserted after certain abbreviations, such as
2945Nonbreaking spaces are inserted after certain abbreviations, such as
2840−Note: if your LaTeX template uses the \f[C]csquotes\f[] package, pandoc
2948+Note: if your LaTeX template calls for the \f[C]csquotes\f[] package,
2841−will detect automatically this and use \f[C]\\enquote{...}\f[] for
2949+pandoc will detect this automatically and use \f[C]\\enquote{...}\f[]
2842−quoted text.
2950+for quoted text.
2843.SS Inline formatting
2951.SS Inline formatting
2844.SS Emphasis
2952.SS Emphasis
@@ -2984,14 +3092,13 @@ delimiters.
2984TeX math will be printed in all output formats.
3092TeX math will be printed in all output formats.
2985How it is rendered depends on the output format:
3093How it is rendered depends on the output format:
2987−.B Markdown, LaTeX, Org\-Mode, ConTeXt
3095+.B Markdown, LaTeX, Emacs Org mode, ConTeXt
2988It will appear verbatim between \f[C]$\f[] characters.
3096It will appear verbatim between \f[C]$\f[] characters.
2992.B reStructuredText
3100.B reStructuredText
2993−It will be rendered using an interpreted text role \f[C]:math:\f[], as
3101+It will be rendered using an interpreted text role \f[C]:math:\f[].
@@ -3026,9 +3133,9 @@ otherwise appear verbatim.
3029−.B Docbook
3136+.B DocBook
3030If the \f[C]\-\-mathml\f[] flag is used, it will be rendered using
3137If 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.
3032Otherwise it will be rendered, if possible, using unicode characters.
3139Otherwise it will be rendered, if possible, using unicode characters.
@@ -3079,8 +3186,8 @@ is at \f[C]/cgi\-bin/mimetex.cgi\f[].
3079If the \f[C]\-\-gladtex\f[] option is used, TeX formulas will be
3186If the \f[C]\-\-gladtex\f[] option is used, TeX formulas will be
3080enclosed in \f[C]<eq>\f[] tags in the HTML output.
3187enclosed in \f[C]<eq>\f[] tags in the HTML output.
3081The resulting \f[C]htex\f[] file may then be processed by gladTeX, which
3188The 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
3189+will produce image files for each formula and an HTML file with links to
3083−links to these images.
3190+these images.
3084So, the procedure is:
3191So, the procedure is:
@@ -3360,7 +3467,7 @@ See\ [my\ website].
3360.SS Internal links
3467.SS Internal links
3362To link to another section of the same document, use the automatically
3469To link to another section of the same document, use the automatically
3363−generated identifier (see Header identifiers, below).
3470+generated identifier (see Header identifiers).
3364For example:
3471For example:
@@ -3556,18 +3663,49 @@ T}@T{
3559−Note that \f[C]\&.bib\f[] can generally be used with both BibTeX and
3666+Note that \f[C]\&.bib\f[] can be used with both BibTeX and BibLaTeX
3560−BibLaTeX files, but you can use \f[C]\&.bibtex\f[] to force BibTeX.
3667+files; use \f[C]\&.bibtex\f[] to force BibTeX.
3562Note that \f[C]pandoc\-citeproc\ \-\-bib2json\f[] and
3669Note that \f[C]pandoc\-citeproc\ \-\-bib2json\f[] and
3563\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce \f[C]\&.json\f[] and
3670\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce \f[C]\&.json\f[] and
3564\f[C]\&.yaml\f[] files from any of the supported formats.
3671\f[C]\&.yaml\f[] files from any of the supported formats.
3566−In\-field markup: In bibtex and biblatex databases, pandoc\-citeproc
3673+In\-field markup: In BibTeX and BibLaTeX databases, pandoc\-citeproc
3567−parses (a subset of) LaTeX markup; in CSL JSON databases, an HTML\-like
3674+parses a subset of LaTeX markup; in CSL YAML databases, pandoc markdown;
3568−markup (specs); and in CSL YAML databases, pandoc markdown.
3675+and in CSL JSON databases, an HTML\-like markup:
3677+.B \f[C]<i>...</i>\f[]
3682+.B \f[C]<b>...</b>\f[]
3687+.B \f[C]<span\ style="font\-variant:small\-caps;">...</span>\f[] or \f[C]<sc>...</sc>\f[]
3692+.B \f[C]<sub>...</sub>\f[]
3697+.B \f[C]<sup>...</sup>\f[]
3702+.B \f[C]<span\ class="nocase">...</span>\f[]
3703+prevent a phrase from being capitalized as title case
3569−\f[C]pandoc\-citeproc\ \-j\f[] and \f[C]\-y\f[] interconvert these
3707+\f[C]pandoc\-citeproc\ \-j\f[] and \f[C]\-y\f[] interconvert the CSL
3570−markup formats as far as possible.
3708+JSON and CSL YAML formats as far as possible.
3572As an alternative to specifying a bibliography file, you can include the
3710As an alternative to specifying a bibliography file, you can include the
3573citation data directly in the \f[C]references\f[] field of the
3711citation data directly in the \f[C]references\f[] field of the
@@ -3608,15 +3746,14 @@ references:
3608(\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce these from a
3746(\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[] can produce these from a
3609bibliography file in one of the supported formats.)
3747bibliography file in one of the supported formats.)
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.
3611By default, \f[C]pandoc\-citeproc\f[] will use the Chicago Manual of
3753By default, \f[C]pandoc\-citeproc\f[] will use the Chicago Manual of
3612−Style author\-date format for citations and references.
3754+Style author\-date format.
3613−To use another style, you will need to specify a CSL 1.0 style file in
3755+The CSL project provides further information on finding and editing
3614−the \f[C]csl\f[] metadata field.
3756+styles.
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.
3621Citations go inside square brackets and are separated by semicolons.
3758Citations go inside square brackets and are separated by semicolons.
3622Each citation must have a key, composed of \[aq]\@\[aq] + the citation
3759Each citation must have a key, composed of \[aq]\@\[aq] + the citation
@@ -3629,7 +3766,7 @@ Here are some examples:
3632−Blah\ blah\ [see\ \@doe99,\ pp.\ 33\-35;\ also\ \@smith04,\ ch.\ 1].
3769+Blah\ blah\ [see\ \@doe99,\ pp.\ 33\-35;\ also\ \@smith04,\ chap.\ 1].
3634Blah\ blah\ [\@doe99,\ pp.\ 33\-35,\ 38\-39\ and\ *passim*].
3771Blah\ blah\ [\@doe99,\ pp.\ 33\-35,\ 38\-39\ and\ *passim*].
@@ -3637,6 +3774,25 @@ Blah\ blah\ [\@smith04;\ \@doe99].
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.
3640A minus sign (\f[C]\-\f[]) before the \f[C]\@\f[] will suppress mention
3796A minus sign (\f[C]\-\f[]) before the \f[C]\@\f[] will suppress mention
3641of the author in the citation.
3797of the author in the citation.
3642This can be useful when the author is already mentioned in the text:
3798This 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[]
3692only, but the bibliography will contain entries for \f[C]item1\f[],
3848only, but the bibliography will contain entries for \f[C]item1\f[],
3693\f[C]item2\f[], and \f[C]item3\f[].
3849\f[C]item2\f[], and \f[C]item3\f[].
3695−For LaTeX or PDF output, you can also use NatBib or BibLaTeX to render
3851+For LaTeX or PDF output, you can also use \f[C]natbib\f[] or
3696−bibliography.
3852+\f[C]biblatex\f[] to render bibliography.
3697In order to do so, specify bibliography files as outlined above, and add
3853In order to do so, specify bibliography files as outlined above, and add
3698\f[C]\-\-natbib\f[] or \f[C]\-\-biblatex\f[] argument to \f[C]pandoc\f[]
3854\f[C]\-\-natbib\f[] or \f[C]\-\-biblatex\f[] argument to \f[C]pandoc\f[]
3699invocation.
3855invocation.
@@ -3764,7 +3920,7 @@ Parses PHP Markdown Extra abbreviation keys, like
3767−*[HTML]:\ Hyper\ Text\ Markup\ Language
3923+*[HTML]:\ Hypertext\ Markup\ Language
@@ -3794,7 +3950,8 @@ the header but before any trailing \f[C]#\f[]s in an ATX header).
3794.SS Extension: \f[C]compact_definition_lists\f[]
3950.SS Extension: \f[C]compact_definition_lists\f[]
3796Activates the definition list syntax of pandoc 1.12.x and earlier.
3952Activates 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:
3798.IP \[bu] 2
3955.IP \[bu] 2
3799No blank line is required between consecutive items of the definition
3956No blank line is required between consecutive items of the definition
@@ -3819,7 +3976,7 @@ variants are supported:
3822−.B \f[C]markdown_github\f[] (GitHub\-flavored Markdown)
3979+.B \f[C]markdown_github\f[] (GitHub\-Flavored Markdown)
3823\f[C]pipe_tables\f[], \f[C]raw_html\f[],
3980\f[C]pipe_tables\f[], \f[C]raw_html\f[],
3824\f[C]tex_math_single_backslash\f[], \f[C]fenced_code_blocks\f[],
3981\f[C]tex_math_single_backslash\f[], \f[C]fenced_code_blocks\f[],
3825\f[C]auto_identifiers\f[], \f[C]ascii_identifiers\f[],
3982\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
3862that can be viewed via a web browser.
4019that can be viewed via a web browser.
3863There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
4020There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
3864reveal.js.
4021reveal.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[].
3867Here\[aq]s the markdown source for a simple slide show,
4024Here\[aq]s the markdown source for a simple slide show,
3868\f[C]habits.txt\f[]:
4025\f[C]habits.txt\f[]:
@@ -4053,7 +4210,7 @@ pandoc\ \-t\ beamer\ habits.txt\ \-V\ theme:Warsaw\ \-o\ habits.pdf
4053Note that header attributes will turn into slide attributes (on a
4210Note that header attributes will turn into slide attributes (on a
4054\f[C]<div>\f[] or \f[C]<section>\f[]) in HTML slide formats, allowing
4211\f[C]<div>\f[] or \f[C]<section>\f[]) in HTML slide formats, allowing
4055you to style individual slides.
4212you 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
4057\f[C]allowframebreaks\f[] class, which sets the
4214\f[C]allowframebreaks\f[] class, which sets the
4058\f[C]allowframebreaks\f[] option, causing multiple slides to be created
4215\f[C]allowframebreaks\f[] option, causing multiple slides to be created
4059if the content overfills the frame.
4216if 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[],
4152.B \f[C]creator\f[]
4309.B \f[C]creator\f[]
4153Either a string value, or an object with fields \f[C]role\f[],
4310Either a string value, or an object with fields \f[C]role\f[],
4154\f[C]file\-as\f[], and \f[C]text\f[], or a list of such objects.
4311\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
4156attempt to translate the human\-readable versions (like "author" and
4313attempt to translate the human\-readable versions (like "author" and
4157"editor") to the appropriate marc relators.
4314"editor") to the appropriate marc relators.
@@ -4170,8 +4327,8 @@ common date formats.
4173−.B \f[C]language\f[]
4330+.B \f[C]lang\f[] (or legacy: \f[C]language\f[])
4174−A string value in RFC5646 format.
4331+A string value in BCP 47 format.
4175Pandoc will default to the local language if nothing is specified.
4332Pandoc will default to the local language if nothing is specified.
@@ -4223,7 +4380,8 @@ A string value (path to CSS stylesheet).
4224.B \f[C]page\-progression\-direction\f[]
4381.B \f[C]page\-progression\-direction\f[]
4225Either \f[C]ltr\f[] or \f[C]rtl\f[].
4382Either \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.
4229.SH LITERATE HASKELL SUPPORT
4387.SH LITERATE HASKELL SUPPORT
@@ -4239,7 +4397,7 @@ In markdown input, "bird track" sections will be parsed as Haskell code
4239rather than block quotations.
4397rather than block quotations.
4240Text between \f[C]\\begin{code}\f[] and \f[C]\\end{code}\f[] will also
4398Text between \f[C]\\begin{code}\f[] and \f[C]\\end{code}\f[] will also
4241be treated as Haskell code.
4399be 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
4243\[aq]#\[aq].
4401\[aq]#\[aq].
4244.IP \[bu] 2
4402.IP \[bu] 2
4245In markdown output, code blocks with classes \f[C]haskell\f[] and
4403In 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
4247quotations will be indented one space, so they will not be treated as
4405quotations will be indented one space, so they will not be treated as
4248Haskell code.
4406Haskell code.
4249In addition, headers will be rendered setext\-style (with underlines)
4407In 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).
4251(This is because ghc treats \[aq]#\[aq] characters in column 1 as
4409(This is because ghc treats \[aq]#\[aq] characters in column 1 as
4252introducing line numbers.)
4410introducing line numbers.)
4253.IP \[bu] 2
4411.IP \[bu] 2
@@ -4289,10 +4447,8 @@ and pasted as literate Haskell source.
4290Pandoc will automatically highlight syntax in fenced code blocks that
4448Pandoc will automatically highlight syntax in fenced code blocks that
4291are marked with a language name.
4449are 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,
4450+The Haskell library highlighting\-kate is used for highlighting, which
4295−and LaTeX/PDF output.
4451+works in HTML, Docx, and LaTeX/PDF output.
4296The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
4452The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
4298The default color scheme is \f[C]pygments\f[], which imitates the
4454The 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
4350Barral, Fyodor Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov,
4506Barral, Fyodor Sheremetyev, Gabor Pali, Gavin Beatty, Greg Maslov,
4351Grégory Bataille, Greg Rundlett, gwern, Gwern Branwen, Hans\-Peter
4507Grégory Bataille, Greg Rundlett, gwern, Gwern Branwen, Hans\-Peter
4352Deifel, Henry de Valence, Ilya V.
4508Deifel, 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.
4354Olson, Jan Larres, Jason Ronallo, Jeff Arnold, Jeff Runningen, Jens
4510Olson, Jan Larres, Jason Ronallo, Jeff Arnold, Jeff Runningen, Jens
4355Petersen, Jérémy Bobbio, Jesse Rosenthal, J.
4511Petersen, Jérémy Bobbio, Jesse Rosenthal, J.
4356Lewis Muir, Joe Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan
4512Lewis Muir, Joe Hillenbrand, John MacFarlane, Jonas Smedegaard, Jonathan