@@ -1,13 +1,13 @@
11.\"t
2−.\" Automatically generated by Pandoc 2.10.1
2+.\" Automatically generated by Pandoc 2.11
33.\"
4−.TH "Pandoc User\[aq]s Guide" "" "July 23, 2020" "pandoc 2.10.1" ""
4+.TH "Pandoc User\[cq]s Guide" "" "July 23, 2020" "pandoc 2.11" ""
55.hy
66.SH NAME
77pandoc - general markup converter
88.SH SYNOPSIS
99.PP
10−\f[C]pandoc\f[R] [\f[I]options\f[R]] [\f[I]input-file\f[R]]...
10+\f[C]pandoc\f[R] [\f[I]options\f[R]] [\f[I]input-file\f[R]]\&...
1111.SH DESCRIPTION
1212.PP
1313Pandoc is a Haskell library for converting from one markup format to
@@ -20,10 +20,10 @@ For the full lists of input and output formats, see the \f[C]--from\f[R]
2020and \f[C]--to\f[R] options below.
2121Pandoc can also produce PDF output: see creating a PDF, below.
2222.PP
23−Pandoc\[aq]s enhanced version of Markdown includes syntax for tables,
23+Pandoc\[cq]s enhanced version of Markdown includes syntax for tables,
2424definition lists, metadata blocks, footnotes, citations, math, and much
2525more.
26−See below under Pandoc\[aq]s Markdown.
26+See below under Pandoc\[cq]s Markdown.
2727.PP
2828Pandoc has a modular design: it consists of a set of readers, which
2929parse text in a given format and produce a native representation of the
@@ -33,15 +33,15 @@ Thus, adding an input or output format requires only adding a reader or
3333writer.
3434Users can also run custom pandoc filters to modify the intermediate AST.
3535.PP
36−Because pandoc\[aq]s intermediate representation of a document is less
36+Because pandoc\[cq]s intermediate representation of a document is less
3737expressive than many of the formats it converts between, one should not
3838expect perfect conversions between every format and every other.
3939Pandoc attempts to preserve the structural elements of a document, but
4040not formatting details such as margin size.
4141And some document elements, such as complex tables, may not fit into
42−pandoc\[aq]s simple document model.
43−While conversions from pandoc\[aq]s Markdown to all formats aspire to be
44−perfect, conversions from formats more expressive than pandoc\[aq]s
42+pandoc\[cq]s simple document model.
43+While conversions from pandoc\[cq]s Markdown to all formats aspire to be
44+perfect, conversions from formats more expressive than pandoc\[cq]s
4545Markdown can be expected to be lossy.
4646.SS Using pandoc
4747.PP
@@ -57,9 +57,9 @@ pandoc -o output.html input.txt
5757.fi
5858.PP
5959By default, pandoc produces a document fragment.
60−To produce a standalone document (e.g.
61−a valid HTML file including \f[C]<head>\f[R] and \f[C]<body>\f[R]), use
62−the \f[C]-s\f[R] or \f[C]--standalone\f[R] flag:
60+To produce a standalone document (e.g.\ a valid HTML file including
61+\f[C]<head>\f[R] and \f[C]<body>\f[R]), use the \f[C]-s\f[R] or
62+\f[C]--standalone\f[R] flag:
6363.IP
6464.nf
6565\f[C]
@@ -115,10 +115,10 @@ pandoc -o hello.tex hello.txt
115115.PP
116116will convert \f[C]hello.txt\f[R] from Markdown to LaTeX.
117117If no output file is specified (so that output goes to
118−\f[I]stdout\f[R]), or if the output file\[aq]s extension is unknown, the
118+\f[I]stdout\f[R]), or if the output file\[cq]s extension is unknown, the
119119output format will default to HTML.
120120If no input file is specified (so that input comes from
121−\f[I]stdin\f[R]), or if the input files\[aq] extensions are unknown, the
121+\f[I]stdin\f[R]), or if the input files\[cq] extensions are unknown, the
122122input format will be assumed to be Markdown.
123123.SS Character encoding
124124.PP
@@ -181,6 +181,7 @@ set), \f[C]setspace\f[R] (with \f[C]linestretch\f[R]), and
181181\f[C]babel\f[R] (with \f[C]lang\f[R]).
182182The use of \f[C]xelatex\f[R] or \f[C]lualatex\f[R] as the PDF engine
183183requires \f[C]fontspec\f[R].
184+\f[C]lualatex\f[R] uses \f[C]selnolig\f[R].
184185\f[C]xelatex\f[R] uses \f[C]polyglossia\f[R] (with \f[C]lang\f[R]),
185186\f[C]xecjk\f[R], and \f[C]bidi\f[R] (with the \f[C]dir\f[R] variable
186187set).
@@ -227,12 +228,18 @@ Specify input format.
227228\f[I]FORMAT\f[R] can be:
228229.RS
229230.IP \[bu] 2
231+\f[C]bibtex\f[R] (BibTeX bibliography)
232+.IP \[bu] 2
233+\f[C]biblatex\f[R] (BibLaTeX bibliography)
234+.IP \[bu] 2
230235\f[C]commonmark\f[R] (CommonMark Markdown)
231236.IP \[bu] 2
232237\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)
233238.IP \[bu] 2
234239\f[C]creole\f[R] (Creole 1.0)
235240.IP \[bu] 2
241+\f[C]csljson\f[R] (CSL JSON bibliography)
242+.IP \[bu] 2
236243\f[C]csv\f[R] (CSV table)
237244.IP \[bu] 2
238245\f[C]docbook\f[R] (DocBook)
@@ -263,7 +270,7 @@ if you need extensions not supported in \f[C]gfm\f[R].
263270.IP \[bu] 2
264271\f[C]latex\f[R] (LaTeX)
265272.IP \[bu] 2
266−\f[C]markdown\f[R] (Pandoc\[aq]s Markdown)
273+\f[C]markdown\f[R] (Pandoc\[cq]s Markdown)
267274.IP \[bu] 2
268275\f[C]markdown_mmd\f[R] (MultiMarkdown)
269276.IP \[bu] 2
@@ -319,6 +326,8 @@ Specify output format.
319326.IP \[bu] 2
320327\f[C]context\f[R] (ConTeXt)
321328.IP \[bu] 2
329+\f[C]csljson\f[R] (CSL JSON bibliography)
330+.IP \[bu] 2
322331\f[C]docbook\f[R] or \f[C]docbook4\f[R] (DocBook 4)
323332.IP \[bu] 2
324333\f[C]docbook5\f[R] (DocBook 5)
@@ -339,8 +348,8 @@ if you need extensions not supported in \f[C]gfm\f[R].
339348.IP \[bu] 2
340349\f[C]haddock\f[R] (Haddock markup)
341350.IP \[bu] 2
342−\f[C]html\f[R] or \f[C]html5\f[R] (HTML, i.e.
343−HTML5/XHTML polyglot markup)
351+\f[C]html\f[R] or \f[C]html5\f[R] (HTML, i.e.\ HTML5/XHTML polyglot
352+markup)
344353.IP \[bu] 2
345354\f[C]html4\f[R] (XHTML 1.0 Transitional)
346355.IP \[bu] 2
@@ -364,7 +373,7 @@ HTML5/XHTML polyglot markup)
364373.IP \[bu] 2
365374\f[C]man\f[R] (roff man)
366375.IP \[bu] 2
367−\f[C]markdown\f[R] (Pandoc\[aq]s Markdown)
376+\f[C]markdown\f[R] (Pandoc\[cq]s Markdown)
368377.IP \[bu] 2
369378\f[C]markdown_mmd\f[R] (MultiMarkdown)
370379.IP \[bu] 2
@@ -454,7 +463,7 @@ at the output of \f[C]pandoc --version\f[R].
454463A \f[C]reference.odt\f[R], \f[C]reference.docx\f[R], \f[C]epub.css\f[R],
455464\f[C]templates\f[R], \f[C]slidy\f[R], \f[C]slideous\f[R], or
456465\f[C]s5\f[R] directory placed in this directory will override
457−pandoc\[aq]s normal defaults.
466+pandoc\[cq]s normal defaults.
458467.TP
459468\f[B]\f[CB]-d\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--defaults=\f[B]\f[R]\f[I]FILE\f[R]
460469Specify a set of default option settings.
@@ -507,7 +516,7 @@ List supported output formats, one per line.
507516List supported extensions for \f[I]FORMAT\f[R], one per line, preceded
508517by a \f[C]+\f[R] or \f[C]-\f[R] indicating whether it is enabled by
509518default in \f[I]FORMAT\f[R].
510−If \f[I]FORMAT\f[R] is not specified, defaults for pandoc\[aq]s Markdown
519+If \f[I]FORMAT\f[R] is not specified, defaults for pandoc\[cq]s Markdown
511520are given.
512521.TP
513522\f[B]\f[CB]--list-highlight-languages\f[B]\f[R]
@@ -552,7 +561,7 @@ This option is useful for converting word processing documents where
552561users have used empty paragraphs to create inter-paragraph space.
553562.TP
554563\f[B]\f[CB]--indented-code-classes=\f[B]\f[R]\f[I]CLASSES\f[R]
555−Specify classes to use for indented code blocks--for example,
564+Specify classes to use for indented code blocks\[en]for example,
556565\f[C]perl,numberLines\f[R] or \f[C]haskell\f[R].
557566Multiple classes may be separated by spaces or commas.
558567.TP
@@ -574,7 +583,7 @@ Reading binary files (docx, odt, epub) implies \f[C]--file-scope\f[R].
574583Specify an executable to be used as a filter transforming the pandoc AST
575584after the input is parsed and before the output is written.
576585The executable should read JSON from stdin and write JSON to stdout.
577−The JSON must be formatted like pandoc\[aq]s own JSON input and output.
586+The JSON must be formatted like pandoc\[cq]s own JSON input and output.
578587The name of the output format will be passed to the filter as the first
579588argument.
580589Hence,
@@ -620,7 +629,7 @@ command line.
620629.TP
621630\f[B]\f[CB]-L\f[B]\f[R] \f[I]SCRIPT\f[R], \f[B]\f[CB]--lua-filter=\f[B]\f[R]\f[I]SCRIPT\f[R]
622631Transform the document in a similar fashion as JSON filters (see
623−\f[C]--filter\f[R]), but use pandoc\[aq]s build-in Lua filtering system.
632+\f[C]--filter\f[R]), but use pandoc\[cq]s build-in Lua filtering system.
624633The given Lua script is expected to return a list of Lua filters which
625634will be applied in order.
626635Each Lua filter must contain element-transforming functions indexed by
@@ -630,7 +639,7 @@ applied.
630639.PP
631640The \f[C]pandoc\f[R] Lua module provides helper functions for element
632641creation.
633−It is always loaded into the script\[aq]s Lua environment.
642+It is always loaded into the script\[cq]s Lua environment.
634643.PP
635644The following is an example Lua script for macro-expansion:
636645.IP
@@ -694,7 +703,7 @@ Specify the number of spaces per tab (default is 4).
694703.TP
695704\f[B]\f[CB]--track-changes=accept\f[B]\f[R]|\f[B]\f[CB]reject\f[B]\f[R]|\f[B]\f[CB]all\f[B]\f[R]
696705Specifies what to do with insertions, deletions, and comments produced
697−by the MS Word \[dq]Track Changes\[dq] feature.
706+by the MS Word \[lq]Track Changes\[rq] feature.
698707\f[C]accept\f[R] (the default), inserts all insertions, and ignores all
699708deletions.
700709\f[C]reject\f[R] inserts all deletions and ignores insertions.
@@ -737,8 +746,8 @@ sentence-ending space in formats like LaTeX.
737746.SS General writer options
738747.TP
739748\f[B]\f[CB]-s\f[B]\f[R], \f[B]\f[CB]--standalone\f[B]\f[R]
740−Produce output with an appropriate header and footer (e.g.
741−a standalone HTML, LaTeX, TEI, or RTF file, not a fragment).
749+Produce output with an appropriate header and footer (e.g.\ a standalone
750+HTML, LaTeX, TEI, or RTF file, not a fragment).
742751This option is set automatically for \f[C]pdf\f[R], \f[C]epub\f[R],
743752\f[C]epub3\f[R], \f[C]fb2\f[R], \f[C]docx\f[R], and \f[C]odt\f[R]
744753output.
@@ -898,8 +907,7 @@ Implies \f[C]--standalone\f[R].
898907.TP
899908\f[B]\f[CB]-B\f[B]\f[R] \f[I]FILE\f[R], \f[B]\f[CB]--include-before-body=\f[B]\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
900909Include contents of \f[I]FILE\f[R], verbatim, at the beginning of the
901−document body (e.g.
902−after the \f[C]<body>\f[R] tag in HTML, or the
910+document body (e.g.\ after the \f[C]<body>\f[R] tag in HTML, or the
903911\f[C]\[rs]begin{document}\f[R] command in LaTeX).
904912This can be used to include navigation bars or banners in HTML
905913documents.
@@ -937,7 +945,7 @@ together with \f[C]--extract-media\f[R].
937945Set the request header \f[I]NAME\f[R] to the value \f[I]VAL\f[R] when
938946making HTTP requests (for example, when a URL is given on the command
939947line, or when resources used in a document must be downloaded).
940−If you\[aq]re behind a proxy, you also need to set the environment
948+If you\[cq]re behind a proxy, you also need to set the environment
941949variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
942950.TP
943951\f[B]\f[CB]--no-check-certificate\f[B]\f[R]
@@ -951,7 +959,7 @@ Produce a standalone HTML file with no external dependencies, using
951959\f[C]data:\f[R] URIs to incorporate the contents of linked scripts,
952960stylesheets, images, and videos.
953961Implies \f[C]--standalone\f[R].
954−The resulting file should be \[dq]self-contained,\[dq] in the sense that
962+The resulting file should be \[lq]self-contained,\[rq] in the sense that
955963it needs no external files and no net access to be displayed properly by
956964a browser.
957965This option works only with HTML output formats, including
@@ -967,9 +975,9 @@ left alone; the documents they link to will not be incorporated in the
967975document.
968976Limitation: resources that are loaded dynamically through JavaScript
969977cannot be incorporated; as a result, \f[C]--self-contained\f[R] does not
970−work with \f[C]--mathjax\f[R], and some advanced features (e.g.
971−zoom or speaker notes) may not work in an offline
972−\[dq]self-contained\[dq] \f[C]reveal.js\f[R] slide show.
978+work with \f[C]--mathjax\f[R], and some advanced features (e.g.\ zoom or
979+speaker notes) may not work in an offline \[lq]self-contained\[rq]
980+\f[C]reveal.js\f[R] slide show.
973981.TP
974982\f[B]\f[CB]--html-q-tags\f[B]\f[R]
975983Use \f[C]<q>\f[R] tags for quotes in HTML.
@@ -1026,16 +1034,16 @@ By default, sections are not numbered.
10261034Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
10271035\f[C]--number-sections\f[R] is specified.
10281036.TP
1029−\f[B]\f[CB]--number-offset=\f[B]\f[R]\f[I]NUMBER\f[R][\f[B]\f[CB],\f[B]\f[R]\f[I]NUMBER\f[R]\f[B]\f[CB],\f[B]\f[R]\f[I]...\f[R]]
1037+\f[B]\f[CB]--number-offset=\f[B]\f[R]\f[I]NUMBER\f[R][\f[B]\f[CB],\f[B]\f[R]\f[I]NUMBER\f[R]\f[B]\f[CB],\f[B]\f[R]\f[I]\&...\f[R]]
10301038Offset for section headings in HTML output (ignored in other output
10311039formats).
10321040The first number is added to the section number for top-level headings,
10331041the second for second-level headings, and so on.
10341042So, for example, if you want the first top-level heading in your
1035−document to be numbered \[dq]6\[dq], specify
1043+document to be numbered \[lq]6\[rq], specify
10361044\f[C]--number-offset=5\f[R].
10371045If your document starts with a level-2 heading which you want to be
1038−numbered \[dq]1.5\[dq], specify \f[C]--number-offset=1,4\f[R].
1046+numbered \[lq]1.5\[rq], specify \f[C]--number-offset=1,4\f[R].
10391047Offsets are 0 by default.
10401048Implies \f[C]--number-sections\f[R].
10411049.TP
@@ -1334,7 +1342,7 @@ body { font-family: \[dq]DejaVuSans\[dq]; }
13341342.TP
13351343\f[B]\f[CB]--epub-chapter-level=\f[B]\f[R]\f[I]NUMBER\f[R]
13361344Specify the heading level at which to split the EPUB into separate
1337−\[dq]chapter\[dq] files.
1345+\[lq]chapter\[rq] files.
13381346The default is to split into chapters at level-1 headings.
13391347This option only affects the internal composition of the EPUB, not the
13401348way chapters and sections are displayed to users.
@@ -1386,47 +1394,64 @@ introduction to PDF generation from HTML/CSS.)
13861394Use the given string as a command-line argument to the
13871395\f[C]pdf-engine\f[R].
13881396For example, to use a persistent directory \f[C]foo\f[R] for
1389−\f[C]latexmk\f[R]\[aq]s auxiliary files, use
1397+\f[C]latexmk\f[R]\[cq]s auxiliary files, use
13901398\f[C]--pdf-engine-opt=-outdir=foo\f[R].
13911399Note that no check for duplicate options is done.
13921400.SS Citation rendering
13931401.TP
1402+\f[B]\f[CB]-C\f[B]\f[R], \f[B]\f[CB]--citeproc\f[B]\f[R]
1403+Process the citations in the file, replacing them with rendered
1404+citations and adding a bibliography.
1405+Citation processing will not take place unless bibliographic data is
1406+supplied, either through an external file specified using the
1407+\f[C]--bibliography\f[R] option or the \f[C]bibliography\f[R] field in
1408+metadata, or via a \f[C]references\f[R] section in metadata containing a
1409+list of citations in CSL YAML format with Markdown formatting.
1410+The style is controlled by a CSL stylesheet specified using the
1411+\f[C]--csl\f[R] option or the \f[C]csl\f[R] field in metadata.
1412+(If no stylesheet is specified, the \f[C]chicago-author-date\f[R] style
1413+will be used by default.) The citation processing transformation may be
1414+applied before or after filters or Lua filters (see \f[C]--filter\f[R],
1415+\f[C]--lua-filter\f[R]): these transformations are applied in the order
1416+they appear on the command line.
1417+For more information, see the section on Citations.
1418+.TP
13941419\f[B]\f[CB]--bibliography=\f[B]\f[R]\f[I]FILE\f[R]
1395−Set the \f[C]bibliography\f[R] field in the document\[aq]s metadata to
1396−\f[I]FILE\f[R], overriding any value set in the metadata, and process
1397−citations using \f[C]pandoc-citeproc\f[R].
1398−(This is equivalent to
1399−\f[C]--metadata bibliography=FILE --filter pandoc-citeproc\f[R].) If
1400−\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] is also supplied,
1401−\f[C]pandoc-citeproc\f[R] is not used, making this equivalent to
1402−\f[C]--metadata bibliography=FILE\f[R].
1420+Set the \f[C]bibliography\f[R] field in the document\[cq]s metadata to
1421+\f[I]FILE\f[R], overriding any value set in the metadata.
14031422If you supply this argument multiple times, each \f[I]FILE\f[R] will be
14041423added to bibliography.
14051424.TP
14061425\f[B]\f[CB]--csl=\f[B]\f[R]\f[I]FILE\f[R]
1407−Set the \f[C]csl\f[R] field in the document\[aq]s metadata to
1426+Set the \f[C]csl\f[R] field in the document\[cq]s metadata to
14081427\f[I]FILE\f[R], overriding any value set in the metadata.
1409−(This is equivalent to \f[C]--metadata csl=FILE\f[R].) This option is
1410−only relevant with \f[C]pandoc-citeproc\f[R].
1428+(This is equivalent to \f[C]--metadata csl=FILE\f[R].) If \f[I]FILE\f[R]
1429+is a URL, it will be fetched via HTTP.
1430+If \f[I]FILE\f[R] is not found relative to the working directory, it
1431+will be sought in the resource path and finally in the \f[C]csl\f[R]
1432+subdirectory of the pandoc user data directory.
14111433.TP
14121434\f[B]\f[CB]--citation-abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
1413−Set the \f[C]citation-abbreviations\f[R] field in the document\[aq]s
1435+Set the \f[C]citation-abbreviations\f[R] field in the document\[cq]s
14141436metadata to \f[I]FILE\f[R], overriding any value set in the metadata.
14151437(This is equivalent to
1416−\f[C]--metadata citation-abbreviations=FILE\f[R].) This option is only
1417−relevant with \f[C]pandoc-citeproc\f[R].
1438+\f[C]--metadata citation-abbreviations=FILE\f[R].) If \f[I]FILE\f[R] is
1439+a URL, it will be fetched via HTTP.
1440+If \f[I]FILE\f[R] is not found relative to the working directory, it
1441+will be sought in the resource path and finally in the \f[C]csl\f[R]
1442+subdirectory of the pandoc user data directory.
14181443.TP
14191444\f[B]\f[CB]--natbib\f[B]\f[R]
14201445Use \f[C]natbib\f[R] for citations in LaTeX output.
1421−This option is not for use with the \f[C]pandoc-citeproc\f[R] filter or
1422−with PDF output.
1446+This option is not for use with the \f[C]--citeproc\f[R] option or with
1447+PDF output.
14231448It is intended for use in producing a LaTeX file that can be processed
14241449with \f[C]bibtex\f[R].
14251450.TP
14261451\f[B]\f[CB]--biblatex\f[B]\f[R]
14271452Use \f[C]biblatex\f[R] for citations in LaTeX output.
1428−This option is not for use with the \f[C]pandoc-citeproc\f[R] filter or
1429−with PDF output.
1453+This option is not for use with the \f[C]--citeproc\f[R] option or with
1454+PDF output.
14301455It is intended for use in producing a LaTeX file that can be processed
14311456with \f[C]bibtex\f[R] or \f[C]biber\f[R].
14321457.SS Math rendering in HTML
@@ -1467,7 +1492,7 @@ For SVG images you can for example use
14671492If no URL is specified, the CodeCogs URL generating PNGs will be used
14681493(\f[C]https://latex.codecogs.com/png.latex?\f[R]).
14691494Note: the \f[C]--webtex\f[R] option will affect Markdown output as well
1470−as HTML, which is useful if you\[aq]re targeting a version of Markdown
1495+as HTML, which is useful if you\[cq]re targeting a version of Markdown
14711496without native math support.
14721497.TP
14731498\f[B]\f[CB]--katex\f[B]\f[R][\f[B]\f[CB]=\f[B]\f[R]\f[I]URL\f[R]]
@@ -1578,6 +1603,11 @@ T}@T{
15781603PandocUnsupportedExtensionError
15791604T}
15801605T{
1606+24
1607+T}@T{
1608+PandocCiteprocError
1609+T}
1610+T{
1581161131
15821612T}@T{
15831613PandocEpubSubdirectoryError
@@ -1707,11 +1737,23 @@ include-after-body: []
17071737include-in-header: []
17081738resource-path: [\[dq].\[dq]]
17091739
1710−# filters will be assumed to be Lua filters if they have
1740+# turn on built-in citation processing. Note that if you need
1741+# control over when the citeproc processing is done relative
1742+# to other filters, you should instead use \[ga]citeproc\[ga] in the
1743+# list of \[ga]filters\[ga] (see below).
1744+citeproc: true
1745+csl: ieee
1746+bibliography:
1747+- foobar.bib
1748+- barbaz.json
1749+
1750+# Filters will be assumed to be Lua filters if they have
17111751# the .lua extension, and json filters otherwise. But
1712−# the filter type can also be specified explicitly, as shown:
1752+# the filter type can also be specified explicitly, as shown.
1753+# Filters are run in the order specified.
1754+# To include the built-in citeproc filter, use either \[ga]citeproc\[ga]
1755+# or \[ga]{type: citeproc}\[ga].
17131756filters:
1714−- pandoc-citeproc
17151757- wordcount.lua
17161758- type: json
17171759 path: foo.lua
@@ -1882,10 +1924,10 @@ arbitrary information at any point in the file.
18821924They may be set at the command line using the \f[C]-V/--variable\f[R]
18831925option.
18841926If a variable is not set, pandoc will look for the key in the
1885−document\[aq]s metadata, which can be set using either YAML metadata
1927+document\[cq]s metadata, which can be set using either YAML metadata
18861928blocks or with the \f[C]-M/--metadata\f[R] option.
18871929In addition, some variables are given default values by pandoc.
1888−See Variables below for a list of variables used in pandoc\[aq]s default
1930+See Variables below for a list of variables used in pandoc\[cq]s default
18891931templates.
18901932.PP
18911933If you use custom templates, you may need to revise them as pandoc
@@ -1902,8 +1944,8 @@ be treated as a comment and omitted from the output.
19021944.SS Delimiters
19031945.PP
19041946To mark variables and control structures in the template, either
1905−\f[C]$\f[R]...\f[C]$\f[R] or \f[C]${\f[R]...\f[C]}\f[R] may be used as
1906−delimiters.
1947+\f[C]$\f[R]\&...\f[C]$\f[R] or \f[C]${\f[R]\&...\f[C]}\f[R] may be used
1948+as delimiters.
19071949The styles may also be mixed in the same template, but the opening and
19081950closing delimiter must match in each case.
19091951The opening delimiter may be followed by one or more spaces or tabs,
@@ -2136,7 +2178,7 @@ an explicit \f[C]for\f[R] loop) cannot contain interpolated variables or
21362178other template directives.
21372179.SS Nesting
21382180.PP
2139−To ensure that content is \[dq]nested,\[dq] that is, subsequent lines
2181+To ensure that content is \[lq]nested,\[rq] that is, subsequent lines
21402182indented, use the \f[C]\[ha]\f[R] directive:
21412183.IP
21422184.nf
@@ -2178,7 +2220,7 @@ will produce
21782220.PP
21792221If a variable occurs by itself on a line, preceded by whitespace and not
21802222followed by further text or directives on the same line, and the
2181−variable\[aq]s value contains multiple lines, it will be nested
2223+variable\[cq]s value contains multiple lines, it will be nested
21822224automatically.
21832225.SS Breakable spaces
21842226.PP
@@ -2410,13 +2452,52 @@ For bidirectional documents, native pandoc \f[C]span\f[R]s and
24102452\f[C]div\f[R]s with the \f[C]dir\f[R] attribute (value \f[C]rtl\f[R] or
24112453\f[C]ltr\f[R]) can be used to override the base direction in some output
24122454formats.
2413−This may not always be necessary if the final renderer (e.g.
2414−the browser, when generating HTML) supports the Unicode Bidirectional
2455+This may not always be necessary if the final renderer (e.g.\ the
2456+browser, when generating HTML) supports the Unicode Bidirectional
24152457Algorithm.
24162458.PP
24172459When using LaTeX for bidirectional documents, only the \f[C]xelatex\f[R]
24182460engine is fully supported (use \f[C]--pdf-engine=xelatex\f[R]).
24192461.RE
2462+.SS Variables for HTML
2463+.TP
2464+\f[B]\f[CB]document-css\f[B]\f[R]
2465+Enables inclusion of most of the CSS in the \f[C]styles.html\f[R]
2466+partial (have a look with
2467+\f[C]pandoc --print-default-data-file=templates/styles.html\f[R]).
2468+Unless you use \f[C]--css\f[R], this variable is set to \f[C]true\f[R]
2469+by default.
2470+You can disable it with e.g.\ \f[C]pandoc -M document-css=false\f[R].
2471+.TP
2472+\f[B]\f[CB]mainfont\f[B]\f[R]
2473+sets the CSS \f[C]font-family\f[R] property on the \f[C]html\f[R]
2474+element.
2475+.TP
2476+\f[B]\f[CB]fontsize\f[B]\f[R]
2477+sets the base CSS \f[C]font-size\f[R], which you\[cq]d usually set to
2478+e.g.\ \f[C]20px\f[R], but it also accepts \f[C]pt\f[R] (12pt = 16px in
2479+most browsers).
2480+.TP
2481+\f[B]\f[CB]fontcolor\f[B]\f[R]
2482+sets the CSS \f[C]color\f[R] property on the \f[C]html\f[R] element.
2483+.TP
2484+\f[B]\f[CB]linkcolor\f[B]\f[R]
2485+sets the CSS \f[C]color\f[R] property on all links.
2486+.TP
2487+\f[B]\f[CB]monofont\f[B]\f[R]
2488+sets the CSS \f[C]font-family\f[R] property on \f[C]code\f[R] elements.
2489+.TP
2490+\f[B]\f[CB]linestretch\f[B]\f[R]
2491+sets the CSS \f[C]line-height\f[R] property on the \f[C]html\f[R]
2492+element, which is preferred to be unitless.
2493+.TP
2494+\f[B]\f[CB]backgroundcolor\f[B]\f[R]
2495+sets the CSS \f[C]background-color\f[R] property on the \f[C]html\f[R]
2496+element.
2497+.TP
2498+\f[B]\f[CB]margin-left\f[B]\f[R], \f[B]\f[CB]margin-right\f[B]\f[R], \f[B]\f[CB]margin-top\f[B]\f[R], \f[B]\f[CB]margin-bottom\f[B]\f[R]
2499+sets the corresponding CSS \f[C]padding\f[R] properties on the
2500+\f[C]body\f[R] element.
24202501.SS Variables for HTML math
24212502.TP
24222503\f[B]\f[CB]classoption\f[B]\f[R]
@@ -2424,7 +2505,7 @@ when using KaTeX, you can render display math equations flush left using
24242505YAML metadata or with \f[C]-M classoption=fleqn\f[R].
24252506.SS Variables for HTML slides
24262507.PP
2427−These affect HTML output when producing slide shows with pandoc.
2508+These affect HTML output when [producing slide shows with pandoc].
24282509.PP
24292510All reveal.js configuration options are available as variables.
24302511To turn off boolean flags that default to true in reveal.js, use
@@ -2475,7 +2556,7 @@ navigation symbols; other valid values are \f[C]frame\f[R],
24752556\f[C]vertical\f[R], and \f[C]horizontal\f[R])
24762557.TP
24772558\f[B]\f[CB]section-titles\f[B]\f[R]
2478−enables \[dq]title pages\[dq] for new sections (default is true)
2559+enables \[lq]title pages\[rq] for new sections (default is true)
24792560.TP
24802561\f[B]\f[CB]theme\f[B]\f[R], \f[B]\f[CB]colortheme\f[B]\f[R], \f[B]\f[CB]fonttheme\f[B]\f[R], \f[B]\f[CB]innertheme\f[B]\f[R], \f[B]\f[CB]outertheme\f[B]\f[R]
24812562beamer themes
@@ -2527,8 +2608,8 @@ header-includes: |
25272608.RE
25282609.TP
25292610\f[B]\f[CB]classoption\f[B]\f[R]
2530−option for document class, e.g.
2531−\f[C]oneside\f[R]; repeat for multiple options:
2611+option for document class, e.g.\ \f[C]oneside\f[R]; repeat for multiple
2612+options:
25322613.RS
25332614.IP
25342615.nf
@@ -2549,8 +2630,8 @@ document class: usually one of the standard classes, \f[C]article\f[R],
25492630default to smaller margins; or \f[C]memoir\f[R]
25502631.TP
25512632\f[B]\f[CB]geometry\f[B]\f[R]
2552−option for \f[C]geometry\f[R] package, e.g.
2553−\f[C]margin=1in\f[R]; repeat for multiple options:
2633+option for \f[C]geometry\f[R] package, e.g.\ \f[C]margin=1in\f[R];
2634+repeat for multiple options:
25542635.RS
25552636.IP
25562637.nf
@@ -2566,8 +2647,8 @@ geometry:
25662647.RE
25672648.TP
25682649\f[B]\f[CB]hyperrefoptions\f[B]\f[R]
2569−option for \f[C]hyperref\f[R] package, e.g.
2570−\f[C]linktoc=all\f[R]; repeat for multiple options:
2650+option for \f[C]hyperref\f[R] package, e.g.\ \f[C]linktoc=all\f[R];
2651+repeat for multiple options:
25712652.RS
25722653.IP
25732654.nf
@@ -2587,8 +2668,8 @@ uses document class settings for indentation (the default LaTeX template
25872668otherwise removes indentation and adds space between paragraphs)
25882669.TP
25892670\f[B]\f[CB]linestretch\f[B]\f[R]
2590−adjusts line spacing using the \f[C]setspace\f[R] package, e.g.
2591−\f[C]1.25\f[R], \f[C]1.5\f[R]
2671+adjusts line spacing using the \f[C]setspace\f[R] package,
2672+e.g.\ \f[C]1.25\f[R], \f[C]1.5\f[R]
25922673.TP
25932674\f[B]\f[CB]margin-left\f[B]\f[R], \f[B]\f[CB]margin-right\f[B]\f[R], \f[B]\f[CB]margin-top\f[B]\f[R], \f[B]\f[CB]margin-bottom\f[B]\f[R]
25942675sets margins if \f[C]geometry\f[R] is not used (otherwise
@@ -2600,8 +2681,7 @@ control \f[C]\[rs]pagestyle{}\f[R]: the default article class supports
26002681numbers), and \f[C]headings\f[R] (section titles in running heads)
26012682.TP
26022683\f[B]\f[CB]papersize\f[B]\f[R]
2603−paper size, e.g.
2604−\f[C]letter\f[R], \f[C]a4\f[R]
2684+paper size, e.g.\ \f[C]letter\f[R], \f[C]a4\f[R]
26052685.TP
26062686\f[B]\f[CB]secnumdepth\f[B]\f[R]
26072687numbering depth for sections (with \f[C]--number-sections\f[R] option or
@@ -2726,35 +2806,32 @@ list of options for natbib
27262806Pandoc uses these variables when creating a PDF with ConTeXt.
27272807.TP
27282808\f[B]\f[CB]fontsize\f[B]\f[R]
2729−font size for body text (e.g.
2730−\f[C]10pt\f[R], \f[C]12pt\f[R])
2809+font size for body text (e.g.\ \f[C]10pt\f[R], \f[C]12pt\f[R])
27312810.TP
27322811\f[B]\f[CB]headertext\f[B]\f[R], \f[B]\f[CB]footertext\f[B]\f[R]
27332812text to be placed in running header or footer (see ConTeXt Headers and
27342813Footers); repeat up to four times for different placement
27352814.TP
27362815\f[B]\f[CB]indenting\f[B]\f[R]
2737−controls indentation of paragraphs, e.g.
2738−\f[C]yes,small,next\f[R] (see ConTeXt Indentation); repeat for multiple
2739−options
2816+controls indentation of paragraphs, e.g.\ \f[C]yes,small,next\f[R] (see
2817+ConTeXt Indentation); repeat for multiple options
27402818.TP
27412819\f[B]\f[CB]interlinespace\f[B]\f[R]
2742−adjusts line spacing, e.g.
2743−\f[C]4ex\f[R] (using \f[C]setupinterlinespace\f[R]); repeat for multiple
2744−options
2820+adjusts line spacing, e.g.\ \f[C]4ex\f[R] (using
2821+\f[C]setupinterlinespace\f[R]); repeat for multiple options
27452822.TP
27462823\f[B]\f[CB]layout\f[B]\f[R]
27472824options for page margins and text arrangement (see ConTeXt Layout);
27482825repeat for multiple options
27492826.TP
27502827\f[B]\f[CB]linkcolor\f[B]\f[R], \f[B]\f[CB]contrastcolor\f[B]\f[R]
2751−color for links outside and inside a page, e.g.
2752−\f[C]red\f[R], \f[C]blue\f[R] (see ConTeXt Color)
2828+color for links outside and inside a page, e.g.\ \f[C]red\f[R],
2829+\f[C]blue\f[R] (see ConTeXt Color)
27532830.TP
27542831\f[B]\f[CB]linkstyle\f[B]\f[R]
2755−typeface style for links, e.g.
2756−\f[C]normal\f[R], \f[C]bold\f[R], \f[C]slanted\f[R],
2757−\f[C]boldslanted\f[R], \f[C]type\f[R], \f[C]cap\f[R], \f[C]small\f[R]
2832+typeface style for links, e.g.\ \f[C]normal\f[R], \f[C]bold\f[R],
2833+\f[C]slanted\f[R], \f[C]boldslanted\f[R], \f[C]type\f[R], \f[C]cap\f[R],
2834+\f[C]small\f[R]
27582835.TP
27592836\f[B]\f[CB]lof\f[B]\f[R], \f[B]\f[CB]lot\f[B]\f[R]
27602837include list of figures, list of tables
@@ -2772,19 +2849,16 @@ page number style and location (using \f[C]setuppagenumbering\f[R]);
27722849repeat for multiple options
27732850.TP
27742851\f[B]\f[CB]papersize\f[B]\f[R]
2775−paper size, e.g.
2776−\f[C]letter\f[R], \f[C]A4\f[R], \f[C]landscape\f[R] (see ConTeXt Paper
2777−Setup); repeat for multiple options
2852+paper size, e.g.\ \f[C]letter\f[R], \f[C]A4\f[R], \f[C]landscape\f[R]
2853+(see ConTeXt Paper Setup); repeat for multiple options
27782854.TP
27792855\f[B]\f[CB]pdfa\f[B]\f[R]
27802856adds to the preamble the setup necessary to generate PDF/A of the type
2781−specified, e.g.
2782−\f[C]1a:2005\f[R], \f[C]2a\f[R].
2783−If no type is specified (i.e.
2784−the value is set to True, by e.g.
2785−\f[C]--metadata=pdfa\f[R] or \f[C]pdfa: true\f[R] in a YAML metadata
2786−block), \f[C]1b:2005\f[R] will be used as default, for reasons of
2787−backwards compatibility.
2857+specified, e.g.\ \f[C]1a:2005\f[R], \f[C]2a\f[R].
2858+If no type is specified (i.e.\ the value is set to True, by
2859+e.g.\ \f[C]--metadata=pdfa\f[R] or \f[C]pdfa: true\f[R] in a YAML
2860+metadata block), \f[C]1b:2005\f[R] will be used as default, for reasons
2861+of backwards compatibility.
27882862Using \f[C]--variable=pdfa\f[R] without specified value is not
27892863supported.
27902864To successfully generate PDF/A the required ICC color profiles have to
@@ -2796,8 +2870,7 @@ See also ConTeXt PDFA for more details.
27962870.TP
27972871\f[B]\f[CB]pdfaiccprofile\f[B]\f[R]
27982872when used in conjunction with \f[C]pdfa\f[R], specifies the ICC profile
2799−to use in the PDF, e.g.
2800−\f[C]default.cmyk\f[R].
2873+to use in the PDF, e.g.\ \f[C]default.cmyk\f[R].
28012874If left unspecified, \f[C]sRGB.icc\f[R] is used as default.
28022875May be repeated to include multiple profiles.
28032876Note that the profiles have to be available on the system.
@@ -2805,17 +2878,17 @@ They can be obtained from ConTeXt ICC Profiles.
28052878.TP
28062879\f[B]\f[CB]pdfaintent\f[B]\f[R]
28072880when used in conjunction with \f[C]pdfa\f[R], specifies the output
2808−intent for the colors, e.g.
2809−\f[C]ISO coated v2 300\[rs]letterpercent\[rs]space (ECI)\f[R] If left
2810−unspecified, \f[C]sRGB IEC61966-2.1\f[R] is used as default.
2881+intent for the colors,
2882+e.g.\ \f[C]ISO coated v2 300\[rs]letterpercent\[rs]space (ECI)\f[R] If
2883+left unspecified, \f[C]sRGB IEC61966-2.1\f[R] is used as default.
28112884.TP
28122885\f[B]\f[CB]toc\f[B]\f[R]
28132886include table of contents (can also be set using
28142887\f[C]--toc/--table-of-contents\f[R])
28152888.TP
28162889\f[B]\f[CB]whitespace\f[B]\f[R]
2817−spacing between paragraphs, e.g.
2818−\f[C]none\f[R], \f[C]small\f[R] (using \f[C]setupwhitespace\f[R])
2890+spacing between paragraphs, e.g.\ \f[C]none\f[R], \f[C]small\f[R] (using
2891+\f[C]setupwhitespace\f[R])
28192892.TP
28202893\f[B]\f[CB]includesource\f[B]\f[R]
28212894include all source documents as file attachments in the PDF file
@@ -2853,20 +2926,16 @@ section number in man pages
28532926.SS Variables for ms
28542927.TP
28552928\f[B]\f[CB]fontfamily\f[B]\f[R]
2856−font family (e.g.
2857−\f[C]T\f[R] or \f[C]P\f[R])
2929+font family (e.g.\ \f[C]T\f[R] or \f[C]P\f[R])
28582930.TP
28592931\f[B]\f[CB]indent\f[B]\f[R]
2860−paragraph indent (e.g.
2861−\f[C]2m\f[R])
2932+paragraph indent (e.g.\ \f[C]2m\f[R])
28622933.TP
28632934\f[B]\f[CB]lineheight\f[B]\f[R]
2864−line height (e.g.
2865−\f[C]12p\f[R])
2935+line height (e.g.\ \f[C]12p\f[R])
28662936.TP
28672937\f[B]\f[CB]pointsize\f[B]\f[R]
2868−point size (e.g.
2869−\f[C]10p\f[R])
2938+point size (e.g.\ \f[C]10p\f[R])
28702939.SS Variables set automatically
28712940.PP
28722941Pandoc sets these variables automatically in response to options or
@@ -2882,10 +2951,9 @@ in all HTML based formats (dzslides, epub, html, html4, html5, revealjs,
28822951s5, slideous, slidy).
28832952The recognized formats for \f[C]date\f[R] are: \f[C]mm/dd/yyyy\f[R],
28842953\f[C]mm/dd/yy\f[R], \f[C]yyyy-mm-dd\f[R] (ISO 8601),
2885−\f[C]dd MM yyyy\f[R] (e.g.
2886−either \f[C]02 Apr 2018\f[R] or \f[C]02 April 2018\f[R]),
2887−\f[C]MM dd, yyyy\f[R] (e.g.
2888−\f[C]Apr. 02, 2018\f[R] or
2954+\f[C]dd MM yyyy\f[R] (e.g.\ either \f[C]02 Apr 2018\f[R] or
2955+\f[C]02 April 2018\f[R]), \f[C]MM dd, yyyy\f[R]
2956+(e.g.\ \f[C]Apr. 02, 2018\f[R] or
28892957\f[C]April 02, 2018),\f[R]yyyy[mm[dd]]]\f[C](e.g.\f[R]20180402,
28902958\f[C]201804\f[R] or \f[C]2018\f[R]).
28912959.TP
@@ -2902,7 +2970,7 @@ contents specified by \f[C]-A/--include-after-body\f[R] (may have
29022970multiple values)
29032971.TP
29042972\f[B]\f[CB]meta-json\f[B]\f[R]
2905−JSON representation of all of the document\[aq]s metadata.
2973+JSON representation of all of the document\[cq]s metadata.
29062974Field values are transformed to the selected output format.
29072975.TP
29082976\f[B]\f[CB]numbersections\f[B]\f[R]
@@ -2930,8 +2998,7 @@ $endif$
29302998Similarly, \f[C]outputfile\f[R] can be \f[C]-\f[R] if output goes to the
29312999terminal.
29323000.PP
2933−If you need absolute paths, use e.g.
2934−\f[C]$curdir$/$sourcefile$\f[R].
3001+If you need absolute paths, use e.g.\ \f[C]$curdir$/$sourcefile$\f[R].
29353002.RE
29363003.TP
29373004\f[B]\f[CB]curdir\f[B]\f[R]
@@ -2952,12 +3019,12 @@ An extension can be enabled by adding \f[C]+EXTENSION\f[R] to the format
29523019name and disabled by adding \f[C]-EXTENSION\f[R].
29533020For example, \f[C]--from markdown_strict+footnotes\f[R] is strict
29543021Markdown with footnotes enabled, while
2955−\f[C]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[aq]s Markdown
3022+\f[C]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[cq]s Markdown
29563023without footnotes or pipe tables.
29573024.PP
29583025The markdown reader and writer make by far the most use of extensions.
29593026Extensions only used by them are therefore covered in the section
2960−Pandoc\[aq]s Markdown below (See Markdown variants for
3027+Pandoc\[cq]s Markdown below (See Markdown variants for
29613028\f[C]commonmark\f[R] and \f[C]gfm\f[R].) In the following, extensions
29623029that also work for other formats are covered.
29633030.PP
@@ -2970,7 +3037,7 @@ Markdown cells in Jupyter notebooks (as do command-line options like
29703037Interpret straight quotes as curly quotes, \f[C]---\f[R] as em-dashes,
29713038\f[C]--\f[R] as en-dashes, and \f[C]...\f[R] as ellipses.
29723039Nonbreaking spaces are inserted after certain abbreviations, such as
2973−\[dq]Mr.\[dq]
3040+\[lq]Mr.\[rq]
29743041.PP
29753042This extension can be enabled/disabled for the following formats:
29763043.TP
@@ -3120,7 +3187,7 @@ letters are omitted.
31203187.SS Extension: \f[C]gfm_auto_identifiers\f[R]
31213188.PP
31223189Changes the algorithm used by \f[C]auto_identifiers\f[R] to conform to
3123−GitHub\[aq]s method.
3190+GitHub\[cq]s method.
31243191Spaces are converted to dashes (\f[C]-\f[R]), uppercase characters to
31253192lowercase characters, and punctuation characters other than \f[C]-\f[R]
31263193and \f[C]_\f[R] are removed.
@@ -3130,7 +3197,7 @@ Emojis are replaced by their names.
31303197The extensions \f[C]tex_math_dollars\f[R],
31313198\f[C]tex_math_single_backslash\f[R], and
31323199\f[C]tex_math_double_backslash\f[R] are described in the section about
3133−Pandoc\[aq]s Markdown.
3200+Pandoc\[cq]s Markdown.
31343201.PP
31353202However, they can also be used with HTML input.
31363203This is handy for reading web pages formatted using MathJax, for
@@ -3138,10 +3205,10 @@ example.
31383205.SS Raw HTML/TeX
31393206.PP
31403207The following extensions are described in more detail in their
3141−respective sections of Pandoc\[aq]s Markdown:
3208+respective sections of Pandoc\[cq]s Markdown:
31423209.IP \[bu] 2
31433210\f[C]raw_html\f[R] allows HTML elements which are not representable in
3144−pandoc\[aq]s AST to be parsed as raw HTML.
3211+pandoc\[cq]s AST to be parsed as raw HTML.
31453212By default, this is disabled for HTML input.
31463213.IP \[bu] 2
31473214\f[C]raw_tex\f[R] allows raw LaTeX, TeX, and ConTeXt to be included in a
@@ -3164,7 +3231,7 @@ with mime type \f[C]text/html\f[R] in output cells.
31643231Since the \f[C]ipynb\f[R] reader attempts to preserve the richest
31653232possible outputs when several options are given, you will get best
31663233results if you disable \f[C]raw_html\f[R] and \f[C]raw_tex\f[R] when
3167−converting to formats like \f[C]docx\f[R] which don\[aq]t allow raw
3234+converting to formats like \f[C]docx\f[R] which don\[cq]t allow raw
31683235\f[C]html\f[R] or \f[C]tex\f[R].
31693236.RE
31703237.IP \[bu] 2
@@ -3198,23 +3265,22 @@ the formats above, pandoc will treat the document as literate Haskell
31983265source.
31993266This means that
32003267.IP \[bu] 2
3201−In Markdown input, \[dq]bird track\[dq] sections will be parsed as
3268+In Markdown input, \[lq]bird track\[rq] sections will be parsed as
32023269Haskell code rather than block quotations.
32033270Text between \f[C]\[rs]begin{code}\f[R] and \f[C]\[rs]end{code}\f[R]
32043271will also be treated as Haskell code.
3205−For ATX-style headings the character \[aq]=\[aq] will be used instead of
3206−\[aq]#\[aq].
3272+For ATX-style headings the character `=' will be used instead of `#'.
32073273.IP \[bu] 2
32083274In Markdown output, code blocks with classes \f[C]haskell\f[R] and
32093275\f[C]literate\f[R] will be rendered using bird tracks, and block
32103276quotations will be indented one space, so they will not be treated as
32113277Haskell code.
32123278In addition, headings will be rendered setext-style (with underlines)
3213−rather than ATX-style (with \[aq]#\[aq] characters).
3214−(This is because ghc treats \[aq]#\[aq] characters in column 1 as
3215−introducing line numbers.)
3279+rather than ATX-style (with `#' characters).
3280+(This is because ghc treats `#' characters in column 1 as introducing
3281+line numbers.)
32163282.IP \[bu] 2
3217−In restructured text input, \[dq]bird track\[dq] sections will be parsed
3283+In restructured text input, \[lq]bird track\[rq] sections will be parsed
32183284as Haskell code.
32193285.IP \[bu] 2
32203286In restructured text output, code blocks with class \f[C]haskell\f[R]
@@ -3250,9 +3316,8 @@ writes HTML with the Haskell code in bird tracks, so it can be copied
32503316and pasted as literate Haskell source.
32513317.PP
32523318Note that GHC expects the bird tracks in the first column, so indented
3253−literate code blocks (e.g.
3254−inside an itemized environment) will not be picked up by the Haskell
3255−compiler.
3319+literate code blocks (e.g.\ inside an itemized environment) will not be
3320+picked up by the Haskell compiler.
32563321.SS Other extensions
32573322.SS Extension: \f[C]empty_paragraphs\f[R]
32583323.PP
@@ -3275,7 +3340,7 @@ This extension can be enabled/disabled for the following formats:
32753340.TP
32763341output formats
32773342\f[C]odt\f[R], \f[C]opendocument\f[R]
3278−.SS Extension: \f[C]styles\f[R] {#ext-styles}
3343+.SS Extension: \f[C]styles\f[R]
32793344.PP
32803345When converting from docx, read all docx styles as divs (for paragraph
32813346styles) and spans (for character styles) regardless of whether pandoc
@@ -3298,7 +3363,7 @@ Use this only when you are targetting \f[C]ipynb\f[R] or a
32983363markdown-based output format.
32993364.SS Extension: \f[C]citations\f[R]
33003365.PP
3301−Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted
3366+Some aspects of Pandoc\[cq]s Markdown citation syntax are also accepted
33023367in \f[C]org\f[R] input.
33033368.SS Extension: \f[C]ntb\f[R]
33043369.PP
@@ -3306,10 +3371,10 @@ In the \f[C]context\f[R] output format this enables the use of Natural
33063371Tables (TABLE) instead of the default Extreme Tables (xtables).
33073372Natural tables allow more fine-grained global customization but come at
33083373a performance penalty compared to extreme tables.
3309−.SH PANDOC\[aq]S MARKDOWN
3374+.SH PANDOC\[cq]S MARKDOWN
33103375.PP
33113376Pandoc understands an extended and slightly revised version of John
3312−Gruber\[aq]s Markdown syntax.
3377+Gruber\[cq]s Markdown syntax.
33133378This document explains the syntax, noting differences from standard
33143379Markdown.
33153380Except where noted, these differences can be suppressed by using the
@@ -3326,15 +3391,15 @@ easy to read:
33263391.RS
33273392.PP
33283393A Markdown-formatted document should be publishable as-is, as plain
3329−text, without looking like it\[aq]s been marked up with tags or
3394+text, without looking like it\[cq]s been marked up with tags or
33303395formatting instructions.
3331−-- John Gruber
3396+\[en] John Gruber
33323397.RE
33333398.PP
3334−This principle has guided pandoc\[aq]s decisions in finding syntax for
3399+This principle has guided pandoc\[cq]s decisions in finding syntax for
33353400tables, footnotes, and other extensions.
33363401.PP
3337−There is, however, one respect in which pandoc\[aq]s aims are different
3402+There is, however, one respect in which pandoc\[cq]s aims are different
33383403from the original aims of Markdown.
33393404Whereas Markdown was originally designed with HTML generation in mind,
33403405pandoc is designed for multiple output formats.
@@ -3359,7 +3424,7 @@ a hard line break, since trailing spaces in the cells are ignored.
33593424There are two kinds of headings: Setext and ATX.
33603425.SS Setext-style headings
33613426.PP
3362−A setext-style heading is a line of text \[dq]underlined\[dq] with a row
3427+A setext-style heading is a line of text \[lq]underlined\[rq] with a row
33633428of \f[C]=\f[R] signs (for a level-one heading) or \f[C]-\f[R] signs (for
33643429a level-two heading):
33653430.IP
@@ -3450,7 +3515,7 @@ My other heading {#foo}
34503515(This syntax is compatible with PHP Markdown Extra.)
34513516.PP
34523517Note that although this syntax allows assignment of classes and
3453−key/value attributes, writers generally don\[aq]t use all of this
3518+key/value attributes, writers generally don\[cq]t use all of this
34543519information.
34553520Identifiers, classes, and key/value attributes are used in HTML and
34563521HTML-based formats such as EPUB and slidy.
@@ -3565,7 +3630,7 @@ indented more than three spaces.)
35653630\f[R]
35663631.fi
35673632.PP
3568−A \[dq]lazy\[dq] form, which requires the \f[C]>\f[R] character only on
3633+A \[lq]lazy\[rq] form, which requires the \f[C]>\f[R] character only on
35693634the first line of each block, is also allowed:
35703635.IP
35713636.nf
@@ -3800,8 +3865,8 @@ Here is a simple example:
38003865\f[R]
38013866.fi
38023867.PP
3803−This will produce a \[dq]compact\[dq] list.
3804−If you want a \[dq]loose\[dq] list, in which each item is formatted as a
3868+This will produce a \[lq]compact\[rq] list.
3869+If you want a \[lq]loose\[rq] list, in which each item is formatted as a
38053870paragraph, put spaces between the items:
38063871.IP
38073872.nf
@@ -3829,7 +3894,7 @@ List items look best if subsequent lines are flush with the first line
38293894\f[R]
38303895.fi
38313896.PP
3832−But Markdown also allows a \[dq]lazy\[dq] format:
3897+But Markdown also allows a \[lq]lazy\[rq] format:
38333898.IP
38343899.nf
38353900\f[C]
@@ -3892,7 +3957,7 @@ character after the list marker of the containing list item.
38923957.fi
38933958.PP
38943959As noted above, Markdown allows you to write list items
3895−\[dq]lazily,\[dq] instead of indenting continuation lines.
3960+\[lq]lazily,\[rq] instead of indenting continuation lines.
38963961However, if there are multiple paragraphs or other blocks in a list
38973962item, the first line of each must be indented.
38983963.IP
@@ -3946,8 +4011,8 @@ They must be separated from the text that follows by at least one space,
39464011and, if the list marker is a capital letter with a period, by at least
39474012two spaces.
39484013.PP
3949−The \f[C]fancy_lists\f[R] extension also allows \[aq]\f[C]#\f[R]\[aq] to
3950−be used as an ordered list marker in place of a numeral:
4014+The \f[C]fancy_lists\f[R] extension also allows `\f[C]#\f[R]' to be used
4015+as an ordered list marker in place of a numeral:
39514016.IP
39524017.nf
39534018\f[C]
@@ -4040,7 +4105,7 @@ one or more block elements (paragraph, code block, list, etc.), each
40404105indented four spaces or one tab stop.
40414106The body of the definition (including the first line, aside from the
40424107colon or tilde) should be indented four spaces.
4043−However, as with other Markdown lists, you can \[dq]lazily\[dq] omit
4108+However, as with other Markdown lists, you can \[lq]lazily\[rq] omit
40444109indentation except at the beginning of a paragraph or other block
40454110element:
40464111.IP
@@ -4074,7 +4139,7 @@ Term 2
40744139.fi
40754140.PP
40764141Note that space between items in a definition list is required.
4077−(A variant that loosens this requirement, but disallows \[dq]lazy\[dq]
4142+(A variant that loosens this requirement, but disallows \[lq]lazy\[rq]
40784143hard wrapping, can be activated with \f[C]compact_definition_lists\f[R]:
40794144see Non-pandoc extensions, below.)
40804145.SS Numbered example lists
@@ -4082,8 +4147,8 @@ see Non-pandoc extensions, below.)
40824147.PP
40834148The special list marker \f[C]\[at]\f[R] can be used for sequentially
40844149numbered examples.
4085−The first list item with a \f[C]\[at]\f[R] marker will be numbered
4086−\[aq]1\[aq], the next \[aq]2\[aq], and so on, throughout the document.
4150+The first list item with a \f[C]\[at]\f[R] marker will be numbered `1',
4151+the next `2', and so on, throughout the document.
40874152The numbered examples need not occur in a single list; each new list
40884153using \f[C]\[at]\f[R] will take up where the last stopped.
40894154So, for example:
@@ -4119,39 +4184,6 @@ That is, example lists always behave as if the \f[C]four_space_rule\f[R]
41194184extension is set.
41204185This is because example labels tend to be long, and indenting content to
41214186the first non-space character after the label would be awkward.
4122−.SS Compact and loose lists
4123−.PP
4124−Pandoc behaves differently from \f[C]Markdown.pl\f[R] on some \[dq]edge
4125−cases\[dq] involving lists.
4126−Consider this source:
4127−.IP
4128−.nf
4129−\f[C]
4130−+ First
4131−+ Second:
4132− - Fee
4133− - Fie
4134− - Foe
4135−
4136−+ Third
4137−\f[R]
4138−.fi
4139−.PP
4140−Pandoc transforms this into a \[dq]compact list\[dq] (with no
4141−\f[C]<p>\f[R] tags around \[dq]First\[dq], \[dq]Second\[dq], or
4142−\[dq]Third\[dq]), while Markdown puts \f[C]<p>\f[R] tags around
4143−\[dq]Second\[dq] and \[dq]Third\[dq] (but not \[dq]First\[dq]), because
4144−of the blank space around \[dq]Third\[dq].
4145−Pandoc follows a simple rule: if the text is followed by a blank line,
4146−it is treated as a paragraph.
4147−Since \[dq]Second\[dq] is followed by a list, and not a blank line, it
4148−isn\[aq]t treated as a paragraph.
4149−The fact that the list is followed by a blank line is irrelevant.
4150−(Note: Pandoc works this way even when the \f[C]markdown_strict\f[R]
4151−format is specified.
4152−This behavior is consistent with the official Markdown syntax
4153−description, even though it is different from that of
4154−\f[C]Markdown.pl\f[R].)
41554187.SS Ending a list
41564188.PP
41574189What if you want to put an indented code block after a list?
@@ -4169,8 +4201,8 @@ Trouble! Here pandoc (like other Markdown implementations) will treat
41694201\f[C]{ my code block }\f[R] as the second paragraph of item two, and not
41704202as a code block.
41714203.PP
4172−To \[dq]cut off\[dq] the list after item two, you can insert some
4173−non-indented content, like an HTML comment, which won\[aq]t produce
4204+To \[lq]cut off\[rq] the list after item two, you can insert some
4205+non-indented content, like an HTML comment, which won\[cq]t produce
41744206visible output in any format:
41754207.IP
41764208.nf
@@ -4366,7 +4398,7 @@ can be omitted for a headerless table.
43664398The cells of grid tables may contain arbitrary block elements (multiple
43674399paragraphs, code blocks, lists, etc.).
43684400Cells that span multiple columns or rows are not supported.
4369−Grid tables can be created easily using Emacs\[aq] table-mode
4401+Grid tables can be created easily using Emacs\[cq] table-mode
43704402(\f[C]M-x table-insert\f[R]).
43714403.PP
43724404Alignments can be specified as with pipe tables, by putting colons at
@@ -4450,7 +4482,7 @@ lines are wider than column width, then cell contents will not be
44504482wrapped, and the cells will be sized to their contents.
44514483.PP
44524484Note: pandoc also recognizes pipe tables of the following form, as can
4453−be produced by Emacs\[aq] orgtbl-mode:
4485+be produced by Emacs\[cq] orgtbl-mode:
44544486.IP
44554487.nf
44564488\f[C]
@@ -4463,7 +4495,7 @@ be produced by Emacs\[aq] orgtbl-mode:
44634495.PP
44644496The difference is that \f[C]+\f[R] is used instead of \f[C]|\f[R].
44654497Other orgtbl features are not supported.
4466−In particular, to get non-default column alignment, you\[aq]ll need to
4498+In particular, to get non-default column alignment, you\[cq]ll need to
44674499add colons as above.
44684500.SS Metadata blocks
44694501.SS Extension: \f[C]pandoc_title_block\f[R]
@@ -4541,13 +4573,13 @@ All three metadata fields may contain standard inline formatting
45414573.PP
45424574Title blocks will always be parsed, but they will affect the output only
45434575when the \f[C]--standalone\f[R] (\f[C]-s\f[R]) option is chosen.
4544−In HTML output, titles will appear twice: once in the document head --
4545−this is the title that will appear at the top of the window in a browser
4546−-- and once at the beginning of the document body.
4576+In HTML output, titles will appear twice: once in the document head
4577+\[en] this is the title that will appear at the top of the window in a
4578+browser \[en] and once at the beginning of the document body.
45474579The title in the document head can have an optional prefix attached
45484580(\f[C]--title-prefix\f[R] or \f[C]-T\f[R] option).
45494581The title in the body appears as an H1 element with class
4550−\[dq]title\[dq], so it can be suppressed or reformatted with CSS.
4582+\[lq]title\[rq], so it can be suppressed or reformatted with CSS.
45514583If a title prefix is specified with \f[C]-T\f[R] and no title block
45524584appears in the document, the title prefix will be used by itself as the
45534585HTML title.
@@ -4576,7 +4608,7 @@ will yield a man page with the title \f[C]PANDOC\f[R] and section 1.
45764608\f[R]
45774609.fi
45784610.PP
4579−will also have \[dq]Pandoc User Manuals\[dq] in the footer.
4611+will also have \[lq]Pandoc User Manuals\[rq] in the footer.
45804612.IP
45814613.nf
45824614\f[C]
@@ -4584,7 +4616,7 @@ will also have \[dq]Pandoc User Manuals\[dq] in the footer.
45844616\f[R]
45854617.fi
45864618.PP
4587−will also have \[dq]Version 4.0\[dq] in the header.
4619+will also have \[lq]Version 4.0\[rq] in the header.
45884620.SS Extension: \f[C]yaml_metadata_block\f[R]
45894621.PP
45904622A YAML metadata block is a valid YAML object, delimited by a line of
@@ -4700,7 +4732,7 @@ $endfor$
47004732\f[R]
47014733.fi
47024734.PP
4703−Raw content to include in the document\[aq]s header may be specified
4735+Raw content to include in the document\[cq]s header may be specified
47044736using \f[C]header-includes\f[R]; however, it is important to mark up
47054737this content as raw code for a particular output format, using the
47064738\f[C]raw_attribute\f[R] extension), or it will be interpreted as
@@ -4747,7 +4779,7 @@ instead of
47474779\f[R]
47484780.fi
47494781.PP
4750−This rule is easier to remember than standard Markdown\[aq]s rule, which
4782+This rule is easier to remember than standard Markdown\[cq]s rule, which
47514783allows only the following characters to be backslash-escaped:
47524784.IP
47534785.nf
@@ -4763,16 +4795,15 @@ A backslash-escaped space is parsed as a nonbreaking space.
47634795In TeX output, it will appear as \f[C]\[ti]\f[R].
47644796In HTML and XML output, it will appear as a literal unicode nonbreaking
47654797space character (note that it will thus actually look
4766−\[dq]invisible\[dq] in the generated HTML source; you can still use the
4798+\[lq]invisible\[rq] in the generated HTML source; you can still use the
47674799\f[C]--ascii\f[R] command-line option to make it appear as an explicit
47684800entity).
47694801.PP
4770−A backslash-escaped newline (i.e.
4771−a backslash occurring at the end of a line) is parsed as a hard line
4772−break.
4802+A backslash-escaped newline (i.e.\ a backslash occurring at the end of a
4803+line) is parsed as a hard line break.
47734804It will appear in TeX output as \f[C]\[rs]\[rs]\f[R] and in HTML as
47744805\f[C]<br />\f[R].
4775−This is a nice alternative to Markdown\[aq]s \[dq]invisible\[dq] way of
4806+This is a nice alternative to Markdown\[cq]s \[lq]invisible\[rq] way of
47764807indicating hard line breaks using two trailing spaces on a line.
47774808.PP
47784809Backslash escapes do not work in verbatim contexts.
@@ -4849,8 +4880,8 @@ If the superscripted or subscripted text contains spaces, these spaces
48494880must be escaped with backslashes.
48504881(This is to prevent accidental superscripting and subscripting through
48514882the ordinary use of \f[C]\[ti]\f[R] and \f[C]\[ha]\f[R], and also bad
4852−interactions with footnotes.) Thus, if you want the letter P with \[aq]a
4853−cat\[aq] in subscripts, use \f[C]P\[ti]a\[rs] cat\[ti]\f[R], not
4883+interactions with footnotes.) Thus, if you want the letter P with `a
4884+cat' in subscripts, use \f[C]P\[ti]a\[rs] cat\[ti]\f[R], not
48544885\f[C]P\[ti]a cat\[ti]\f[R].
48554886.SS Verbatim
48564887.PP
@@ -4930,9 +4961,9 @@ The opening \f[C]$\f[R] must have a non-space character immediately to
49304961its right, while the closing \f[C]$\f[R] must have a non-space character
49314962immediately to its left, and must not be followed immediately by a
49324963digit.
4933−Thus, \f[C]$20,000 and $30,000\f[R] won\[aq]t parse as math.
4964+Thus, \f[C]$20,000 and $30,000\f[R] won\[cq]t parse as math.
49344965If for some reason you need to enclose text in literal \f[C]$\f[R]
4935−characters, backslash-escape them and they won\[aq]t be treated as math
4966+characters, backslash-escape them and they won\[cq]t be treated as math
49364967delimiters.
49374968.PP
49384969For display math, use \f[C]$$\f[R] delimiters.
@@ -4968,7 +4999,7 @@ Texinfo
49684999It will be rendered inside a \f[C]\[at]math\f[R] command.
49695000.TP
49705001roff man, Jira markup
4971−It will be rendered verbatim without \f[C]$\f[R]\[aq]s.
5002+It will be rendered verbatim without \f[C]$\f[R]\[cq]s.
49725003.TP
49735004MediaWiki, DokuWiki
49745005It will be rendered inside \f[C]<math>\f[R] tags.
@@ -5026,7 +5057,7 @@ Note that even if \f[C]raw_html\f[R] is disabled, tables will be
50265057rendered with HTML syntax if they cannot use pipe syntax.
50275058.SS Extension: \f[C]markdown_in_html_blocks\f[R]
50285059.PP
5029−Standard Markdown allows you to include HTML \[dq]blocks\[dq]: blocks of
5060+Standard Markdown allows you to include HTML \[lq]blocks\[rq]: blocks of
50305061HTML between balanced tags that are separated from the surrounding text
50315062with blank lines, and start and end at the left margin.
50325063Within these blocks, everything is interpreted as HTML, not Markdown; so
@@ -5364,7 +5395,7 @@ slide shows and EPUB), LaTeX, and ConTeXt.
53645395.PP
53655396A link immediately preceded by a \f[C]!\f[R] will be treated as an
53665397image.
5367−The link text will be used as the image\[aq]s alt text:
5398+The link text will be used as the image\[cq]s alt text:
53685399.IP
53695400.nf
53705401\f[C]
@@ -5379,7 +5410,7 @@ The link text will be used as the image\[aq]s alt text:
53795410.PP
53805411An image with nonempty alt text, occurring by itself in a paragraph,
53815412will be rendered as a figure with a caption.
5382−The image\[aq]s alt text will be used as the caption.
5413+The image\[cq]s alt text will be used as the caption.
53835414.IP
53845415.nf
53855416\f[C]
@@ -5388,9 +5419,8 @@ The image\[aq]s alt text will be used as the caption.
53885419.fi
53895420.PP
53905421How this is rendered depends on the output format.
5391−Some output formats (e.g.
5392−RTF) do not yet support figures.
5393−In those formats, you\[aq]ll just get an image in a paragraph by itself,
5422+Some output formats (e.g.\ RTF) do not yet support figures.
5423+In those formats, you\[cq]ll just get an image in a paragraph by itself,
53945424with no caption.
53955425.PP
53965426If you just want a regular inline image, just make sure it is not the
@@ -5461,7 +5491,7 @@ HTML:
54615491.IP \[bu] 2
54625492LaTeX:
54635493\f[C]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
5464−(If you\[aq]re using a custom template, you need to configure
5494+(If you\[cq]re using a custom template, you need to configure
54655495\f[C]graphicx\f[R] as in the default template.)
54665496.IP \[bu] 2
54675497ConTeXt:
@@ -5544,7 +5574,7 @@ immediately by attributes:
55445574.SS Footnotes
55455575.SS Extension: \f[C]footnotes\f[R]
55465576.PP
5547−Pandoc\[aq]s Markdown allows footnotes, using the following syntax:
5577+Pandoc\[cq]s Markdown allows footnotes, using the following syntax:
55485578.IP
55495579.nf
55505580\f[C]
@@ -5593,182 +5623,14 @@ note.]
55935623.fi
55945624.PP
55955625Inline and regular footnotes may be mixed freely.
5596−.SS Citations
5626+.SS Citation syntax
55975627.SS Extension: \f[C]citations\f[R]
55985628.PP
5599−Using an external filter, \f[C]pandoc-citeproc\f[R], pandoc can
5600−automatically generate citations and a bibliography in a number of
5601−styles.
5602−Basic usage is
5603−.IP
5604−.nf
5605−\f[C]
5606−pandoc --filter pandoc-citeproc myinput.txt
5607−\f[R]
5608−.fi
5609−.PP
5610−In order to use this feature, you will need to specify a bibliography
5611−file using the \f[C]bibliography\f[R] metadata field in a YAML metadata
5612−section, or \f[C]--bibliography\f[R] command line argument.
5613−You can supply multiple \f[C]--bibliography\f[R] arguments or set
5614−\f[C]bibliography\f[R] metadata field to YAML array, if you want to use
5615−multiple bibliography files.
5616−The bibliography may have any of these formats:
5617−.PP
5618−.TS
5619−tab(@);
5620−l l.
5621−T{
5622−Format
5623−T}@T{
5624−File extension
5625−T}
5626−_
5627−T{
5628−BibLaTeX
5629−T}@T{
5630−\&.bib
5631−T}
5632−T{
5633−BibTeX
5634−T}@T{
5635−\&.bibtex
5636−T}
5637−T{
5638−Copac
5639−T}@T{
5640−\&.copac
5641−T}
5642−T{
5643−CSL JSON
5644−T}@T{
5645−\&.json
5646−T}
5647−T{
5648−CSL YAML
5649−T}@T{
5650−\&.yaml
5651−T}
5652−T{
5653−EndNote
5654−T}@T{
5655−\&.enl
5656−T}
5657−T{
5658−EndNote XML
5659−T}@T{
5660−\&.xml
5661−T}
5662−T{
5663−ISI
5664−T}@T{
5665−\&.wos
5666−T}
5667−T{
5668−MEDLINE
5669−T}@T{
5670−\&.medline
5671−T}
5672−T{
5673−MODS
5674−T}@T{
5675−\&.mods
5676−T}
5677−T{
5678−RIS
5679−T}@T{
5680−\&.ris
5681−T}
5682−.TE
5683−.PP
5684−Note that \f[C].bib\f[R] can be used with both BibTeX and BibLaTeX
5685−files; use \f[C].bibtex\f[R] to force BibTeX.
5686−.PP
5687−Note that \f[C]pandoc-citeproc --bib2json\f[R] and
5688−\f[C]pandoc-citeproc --bib2yaml\f[R] can produce \f[C].json\f[R] and
5689−\f[C].yaml\f[R] files from any of the supported formats.
5690−.PP
5691−In-field markup: In BibTeX and BibLaTeX databases, pandoc-citeproc
5692−parses a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown;
5693−and in CSL JSON databases, an HTML-like markup:
5694−.TP
5695−\f[B]\f[CB]<i>...</i>\f[B]\f[R]
5696−italics
5697−.TP
5698−\f[B]\f[CB]<b>...</b>\f[B]\f[R]
5699−bold
5700−.TP
5701−\f[B]\f[CB]<span style=\[dq]font-variant:small-caps;\[dq]>...</span>\f[B]\f[R] or \f[B]\f[CB]<sc>...</sc>\f[B]\f[R]
5702−small capitals
5703−.TP
5704−\f[B]\f[CB]<sub>...</sub>\f[B]\f[R]
5705−subscript
5706−.TP
5707−\f[B]\f[CB]<sup>...</sup>\f[B]\f[R]
5708−superscript
5709−.TP
5710−\f[B]\f[CB]<span class=\[dq]nocase\[dq]>...</span>\f[B]\f[R]
5711−prevent a phrase from being capitalized as title case
5712−.PP
5713−\f[C]pandoc-citeproc -j\f[R] and \f[C]-y\f[R] interconvert the CSL JSON
5714−and CSL YAML formats as far as possible.
5715−.PP
5716−As an alternative to specifying a bibliography file using
5717−\f[C]--bibliography\f[R] or the YAML metadata field
5718−\f[C]bibliography\f[R], you can include the citation data directly in
5719−the \f[C]references\f[R] field of the document\[aq]s YAML metadata.
5720−The field should contain an array of YAML-encoded references, for
5721−example:
5722−.IP
5723−.nf
5724−\f[C]
5725−---
5726−references:
5727−- type: article-journal
5728− id: WatsonCrick1953
5729− author:
5730− - family: Watson
5731− given: J. D.
5732− - family: Crick
5733− given: F. H. C.
5734− issued:
5735− date-parts:
5736− - - 1953
5737− - 4
5738− - 25
5739− title: \[aq]Molecular structure of nucleic acids: a structure for deoxyribose
5740− nucleic acid\[aq]
5741− title-short: Molecular structure of nucleic acids
5742− container-title: Nature
5743− volume: 171
5744− issue: 4356
5745− page: 737-738
5746− DOI: 10.1038/171737a0
5747− URL: https://www.nature.com/articles/171737a0
5748− language: en-GB
5749−\&...
5750−\f[R]
5751−.fi
5752−.PP
5753−(\f[C]pandoc-citeproc --bib2yaml\f[R] can produce these from a
5754−bibliography file in one of the supported formats.)
5755−.PP
5756−Citations and references can be formatted using any style supported by
5757−the Citation Style Language, listed in the Zotero Style Repository.
5758−These files are specified using the \f[C]--csl\f[R] option or the
5759−\f[C]csl\f[R] metadata field.
5760−By default, \f[C]pandoc-citeproc\f[R] will use the Chicago Manual of
5761−Style author-date format.
5762−The CSL project provides further information on finding and editing
5763−styles.
5764−.PP
5765−To make your citations hyperlinks to the corresponding bibliography
5766−entries, add \f[C]link-citations: true\f[R] to your YAML metadata.
5767−.PP
5768−Citations go inside square brackets and are separated by semicolons.
5769−Each citation must have a key, composed of \[aq]\[at]\[aq] + the
5770−citation identifier from the database, and may optionally have a prefix,
5771−a locator, and a suffix.
5629+Markdown citations go inside square brackets and are separated by
5630+semicolons.
5631+Each citation must have a key, composed of `\[at]' + the citation
5632+identifier from the database, and may optionally have a prefix, a
5633+locator, and a suffix.
57725634The citation key must begin with a letter, digit, or \f[C]_\f[R], and
57735635may contain alphanumerics, \f[C]_\f[R], and internal punctuation
57745636characters (\f[C]:.#$%&-+?<>\[ti]/\f[R]).
@@ -5784,7 +5646,7 @@ Blah blah [\[at]smith04; \[at]doe99].
57845646\f[R]
57855647.fi
57865648.PP
5787−\f[C]pandoc-citeproc\f[R] detects locator terms in the CSL locale files.
5649+\f[C]pandoc\f[R] detects locator terms in the CSL locale files.
57885650Either abbreviated or unabbreviated forms are accepted.
57895651In the \f[C]en-US\f[R] locale, locator terms can be written in either
57905652singular or plural forms, as \f[C]book\f[R],
@@ -5804,12 +5666,11 @@ singular or plural forms, as \f[C]book\f[R],
58045666\f[C]v.\f[R]/\f[C]vv.\f[R]; \f[C]volume\f[R],
58055667\f[C]vol.\f[R]/\f[C]vols.\f[R]; \f[C]\[ps]\f[R]/\f[C]\[ps]\[ps]\f[R];
58065668\f[C]\[sc]\f[R]/\f[C]\[sc]\[sc]\f[R].
5807−If no locator term is used, \[dq]page\[dq] is assumed.
5669+If no locator term is used, \[lq]page\[rq] is assumed.
58085670.PP
5809−\f[C]pandoc-citeproc\f[R] will use heuristics to distinguish the locator
5810−from the suffix.
5811−In complex cases, the locator can be enclosed in curly braces (using
5812−\f[C]pandoc-citeproc\f[R] 0.15 and higher only):
5671+\f[C]pandoc\f[R] will use heuristics to distinguish the locator from the
5672+suffix.
5673+In complex cases, the locator can be enclosed in curly braces:
58135674.IP
58145675.nf
58155676\f[C]
@@ -5837,78 +5698,6 @@ You can also write an in-text citation, as follows:
58375698\[at]smith04 [p. 33] says blah.
58385699\f[R]
58395700.fi
5840−.PP
5841−If the style calls for a list of works cited, it will be placed in a div
5842−with id \f[C]refs\f[R], if one exists:
5843−.IP
5844−.nf
5845−\f[C]
5846−::: {#refs}
5847−:::
5848−\f[R]
5849−.fi
5850−.PP
5851−Otherwise, it will be placed at the end of the document.
5852−Generation of the bibliography can be suppressed by setting
5853−\f[C]suppress-bibliography: true\f[R] in the YAML metadata.
5854−.PP
5855−If you wish the bibliography to have a section heading, you can set
5856−\f[C]reference-section-title\f[R] in the metadata, or put the heading at
5857−the beginning of the div with id \f[C]refs\f[R] (if you are using it) or
5858−at the end of your document:
5859−.IP
5860−.nf
5861−\f[C]
5862−last paragraph...
5863−
5864−# References
5865−\f[R]
5866−.fi
5867−.PP
5868−The bibliography will be inserted after this heading.
5869−Note that the \f[C]unnumbered\f[R] class will be added to this heading,
5870−so that the section will not be numbered.
5871−.PP
5872−If you want to include items in the bibliography without actually citing
5873−them in the body text, you can define a dummy \f[C]nocite\f[R] metadata
5874−field and put the citations there:
5875−.IP
5876−.nf
5877−\f[C]
5878−---
5879−nocite: |
5880− \[at]item1, \[at]item2
5881−\&...
5882−
5883−\[at]item3
5884−\f[R]
5885−.fi
5886−.PP
5887−In this example, the document will contain a citation for
5888−\f[C]item3\f[R] only, but the bibliography will contain entries for
5889−\f[C]item1\f[R], \f[C]item2\f[R], and \f[C]item3\f[R].
5890−.PP
5891−It is possible to create a bibliography with all the citations, whether
5892−or not they appear in the document, by using a wildcard:
5893−.IP
5894−.nf
5895−\f[C]
5896−---
5897−nocite: |
5898− \[at]*
5899−\&...
5900−\f[R]
5901−.fi
5902−.PP
5903−For LaTeX output, you can also use \f[C]natbib\f[R] or
5904−\f[C]biblatex\f[R] to render the bibliography.
5905−In order to do so, specify bibliography files as outlined above, and add
5906−\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] argument to \f[C]pandoc\f[R]
5907−invocation.
5908−Bear in mind that bibliography files have to be in respective format
5909−(either BibTeX or BibLaTeX).
5910−.PP
5911−For more information, see the pandoc-citeproc man page.
59125701.SS Non-pandoc extensions
59135702.PP
59145703The following Markdown syntax extensions are not enabled by default in
@@ -5946,7 +5735,7 @@ affect the code block element.
59465735Attributes that occur at the end of a reference link definition affect
59475736links that refer to that definition.
59485737.PP
5949−Note that pandoc\[aq]s AST does not currently allow attributes to be
5738+Note that pandoc\[cq]s AST does not currently allow attributes to be
59505739attached to arbitrary elements.
59515740Hence a Span or Div container will be added if needed.
59525741.SS Extension: \f[C]old_dashes\f[R]
@@ -5960,7 +5749,7 @@ It is selected automatically for \f[C]textile\f[R] input.
59605749.PP
59615750Allow \f[C]<\f[R] and \f[C]>\f[R] to be backslash-escaped, as they can
59625751be in GitHub flavored Markdown but not original Markdown.
5963−This is implied by pandoc\[aq]s default \f[C]all_symbols_escapable\f[R].
5752+This is implied by pandoc\[cq]s default \f[C]all_symbols_escapable\f[R].
59645753.SS Extension: \f[C]lists_without_preceding_blankline\f[R]
59655754.PP
59665755Allow a list to occur right after a paragraph, with no intervening blank
@@ -6084,7 +5873,7 @@ in several respects:
60845873No blank line is required between consecutive items of the definition
60855874list.
60865875.IP \[bu] 2
6087−To get a \[dq]tight\[dq] or \[dq]compact\[dq] list, omit space between
5876+To get a \[lq]tight\[rq] or \[lq]compact\[rq] list, omit space between
60885877consecutive items; the space between a term and its definition does not
60895878affect anything.
60905879.IP \[bu] 2
@@ -6097,63 +5886,421 @@ for strong emphasis, surround by underscores for regular emphasis, add
60975886extra blank space around headings.
60985887.SS Markdown variants
60995888.PP
6100−In addition to pandoc\[aq]s extended Markdown, the following Markdown
5889+In addition to pandoc\[cq]s extended Markdown, the following Markdown
61015890variants are supported:
5891+.IP \[bu] 2
5892+\f[C]markdown_phpextra\f[R] (PHP Markdown Extra)
5893+.IP \[bu] 2
5894+\f[C]markdown_github\f[R] (deprecated GitHub-Flavored Markdown)
5895+.IP \[bu] 2
5896+\f[C]markdown_mmd\f[R] (MultiMarkdown)
5897+.IP \[bu] 2
5898+\f[C]markdown_strict\f[R] (Markdown.pl)
5899+.IP \[bu] 2
5900+\f[C]commonmark\f[R] (CommonMark)
5901+.IP \[bu] 2
5902+\f[C]gfm\f[R] (Github-Flavored Markdown)
5903+.IP \[bu] 2
5904+\f[C]commonmark_x\f[R] (CommonMark with many pandoc extensions)
5905+.PP
5906+To see which extensions are supported for a given format, and which are
5907+enabled by default, you can use the command
5908+.IP
5909+.nf
5910+\f[C]
5911+pandoc --list-extensions=FORMAT
5912+\f[R]
5913+.fi
5914+.PP
5915+where \f[C]FORMAT\f[R] is replaced with the name of the format.
5916+.PP
5917+Note that the list of extensions for \f[C]commonmark\f[R],
5918+\f[C]gfm\f[R], and \f[C]commonmark_x\f[R] are defined relative to
5919+default commonmark.
5920+So, for example, \f[C]backtick_code_blocks\f[R] does not appear as an
5921+extension, since it is enabled by default and cannot be disabled.
5922+.SH CITATIONS
5923+.PP
5924+When the \f[C]--citeproc\f[R] option is used, pandoc can automatically
5925+generate citations and a bibliography in a number of styles.
5926+Basic usage is
5927+.IP
5928+.nf
5929+\f[C]
5930+pandoc --citeproc myinput.txt
5931+\f[R]
5932+.fi
5933+.PP
5934+To use this feature, you will need to have
5935+.IP \[bu] 2
5936+a document containing citations (see Extension: \f[C]citations\f[R]);
5937+.IP \[bu] 2
5938+a source of bibliographic data: either an external bibliography file or
5939+a list of \f[C]references\f[R] in the document\[cq]s YAML metadata
5940+.IP \[bu] 2
5941+optionally, a CSL citation style.
5942+.SS Specifying bibliographic data
5943+.PP
5944+You can specify an external bibliography using the
5945+\f[C]bibliography\f[R] metadata field in a YAML metadata section or the
5946+\f[C]--bibliography\f[R] command line argument.
5947+If you want to use multiple bibliography files, you can supply multiple
5948+\f[C]--bibliography\f[R] arguments or set \f[C]bibliography\f[R]
5949+metadata field to YAML array.
5950+A bibliography may have any of these formats:
5951+.PP
5952+.TS
5953+tab(@);
5954+l l.
5955+T{
5956+Format
5957+T}@T{
5958+File extension
5959+T}
5960+_
5961+T{
5962+BibLaTeX
5963+T}@T{
5964+\&.bib
5965+T}
5966+T{
5967+BibTeX
5968+T}@T{
5969+\&.bibtex
5970+T}
5971+T{
5972+CSL JSON
5973+T}@T{
5974+\&.json
5975+T}
5976+T{
5977+CSL YAML
5978+T}@T{
5979+\&.yaml
5980+T}
5981+.TE
5982+.PP
5983+Note that \f[C].bib\f[R] can be used with both BibTeX and BibLaTeX
5984+files; use the extension \f[C].bibtex\f[R] to force interpretation as
5985+BibTeX.
5986+.PP
5987+In BibTeX and BibLaTeX databases, pandoc parses LaTeX markup inside
5988+fields such as \f[C]title\f[R]; in CSL YAML databases, pandoc Markdown;
5989+and in CSL JSON databases, an HTML-like markup:
5990+.TP
5991+\f[B]\f[CB]<i>...</i>\f[B]\f[R]
5992+italics
5993+.TP
5994+\f[B]\f[CB]<b>...</b>\f[B]\f[R]
5995+bold
5996+.TP
5997+\f[B]\f[CB]<span style=\[dq]font-variant:small-caps;\[dq]>...</span>\f[B]\f[R] or \f[B]\f[CB]<sc>...</sc>\f[B]\f[R]
5998+small capitals
5999+.TP
6000+\f[B]\f[CB]<sub>...</sub>\f[B]\f[R]
6001+subscript
6002+.TP
6003+\f[B]\f[CB]<sup>...</sup>\f[B]\f[R]
6004+superscript
6005+.TP
6006+\f[B]\f[CB]<span class=\[dq]nocase\[dq]>...</span>\f[B]\f[R]
6007+prevent a phrase from being capitalized as title case
6008+.PP
6009+As an alternative to specifying a bibliography file using
6010+\f[C]--bibliography\f[R] or the YAML metadata field
6011+\f[C]bibliography\f[R], you can include the citation data directly in
6012+the \f[C]references\f[R] field of the document\[cq]s YAML metadata.
6013+The field should contain an array of YAML-encoded references, for
6014+example:
6015+.IP
6016+.nf
6017+\f[C]
6018+---
6019+references:
6020+- type: article-journal
6021+ id: WatsonCrick1953
6022+ author:
6023+ - family: Watson
6024+ given: J. D.
6025+ - family: Crick
6026+ given: F. H. C.
6027+ issued:
6028+ date-parts:
6029+ - - 1953
6030+ - 4
6031+ - 25
6032+ title: \[aq]Molecular structure of nucleic acids: a structure for
6033+ deoxyribose nucleic acid\[aq]
6034+ title-short: Molecular structure of nucleic acids
6035+ container-title: Nature
6036+ volume: 171
6037+ issue: 4356
6038+ page: 737-738
6039+ DOI: 10.1038/171737a0
6040+ URL: https://www.nature.com/articles/171737a0
6041+ language: en-GB
6042+\&...
6043+\f[R]
6044+.fi
6045+.PP
6046+Note that \f[C]pandoc\f[R] can be used to produce such a YAML metadata
6047+section from a BibTeX, BibLaTeX, or CSL JSON bibliography:
6048+.IP
6049+.nf
6050+\f[C]
6051+pandoc chem.bib -s -t markdown
6052+pandoc chem.json -s -t markdown
6053+\f[R]
6054+.fi
6055+.PP
6056+\f[C]pandoc\f[R] can also be used to produce CSL JSON bibliography from
6057+BibTeX, BibLaTeX, or markdown YAML:
6058+.IP
6059+.nf
6060+\f[C]
6061+pandoc chem.bib -s -t csljson
6062+pandoc chem.yaml -s -t csljson
6063+\f[R]
6064+.fi
6065+.PP
6066+Running pandoc on a bibliography file with the \f[C]--citeproc\f[R]
6067+option will create a formatted bibliography in the format of your
6068+choice:
6069+.IP
6070+.nf
6071+\f[C]
6072+pandoc chem.bib -s --citeproc -o chem.html
6073+pandoc chem.bib -s --citeproc -o chem.pdf
6074+\f[R]
6075+.fi
6076+.SS Capitalization in titles
6077+.PP
6078+If you are using a bibtex or biblatex bibliography, then observe the
6079+following rules:
6080+.IP \[bu] 2
6081+English titles should be in title case.
6082+Non-English titles should be in sentence case, and the \f[C]langid\f[R]
6083+field in biblatex should be set to the relevant language.
6084+(The following values are treated as English: \f[C]american\f[R],
6085+\f[C]british\f[R], \f[C]canadian\f[R], \f[C]english\f[R],
6086+\f[C]australian\f[R], \f[C]newzealand\f[R], \f[C]USenglish\f[R], or
6087+\f[C]UKenglish\f[R].)
6088+.IP \[bu] 2
6089+As is standard with bibtex/biblatex, proper names should be protected
6090+with curly braces so that they won\[cq]t be lowercased in styles that
6091+call for sentence case.
6092+For example:
6093+.RS 2
6094+.IP
6095+.nf
6096+\f[C]
6097+title = {My Dinner with {Andre}}
6098+\f[R]
6099+.fi
6100+.RE
6101+.IP \[bu] 2
6102+In addition, words that should remain lowercase (or camelCase) should be
6103+protected:
6104+.RS 2
6105+.IP
6106+.nf
6107+\f[C]
6108+title = {Spin Wave Dispersion on the {nm} Scale}
6109+\f[R]
6110+.fi
6111+.PP
6112+Though this is not necessary in bibtex/biblatex, it is necessary with
6113+citeproc, which stores titles internally in sentence case, and converts
6114+to title case in styles that require it.
6115+Here we protect \[lq]nm\[rq] so that it doesn\[cq]t get converted to
6116+\[lq]Nm\[rq] at this stage.
6117+.RE
6118+.PP
6119+If you are using a CSL bibliography (either JSON or YAML), then observe
6120+the following rules:
6121+.IP \[bu] 2
6122+All titles should be in sentence case.
6123+.IP \[bu] 2
6124+Use the \f[C]language\f[R] field for non-English titles to prevent their
6125+conversion to title case in styles that call for this.
6126+(Conversion happens only if \f[C]language\f[R] begins with \f[C]en\f[R]
6127+or is left empty.)
6128+.IP \[bu] 2
6129+Protect words that should not be converted to title case using this
6130+syntax:
6131+.RS 2
6132+.IP
6133+.nf
6134+\f[C]
6135+Spin wave dispersion on the <span class=\[dq]nocase\[dq]>nm</span> scale
6136+\f[R]
6137+.fi
6138+.RE
6139+.SS Conference Papers, Published vs.\ Unpublished
6140+.PP
6141+For a formally published conference paper, use the biblatex entry type
6142+\f[C]inproceedings\f[R] (which will be mapped to CSL
6143+\f[C]paper-conference\f[R]).
6144+.PP
6145+For an unpublished manuscript, use the biblatex entry type
6146+\f[C]unpublished\f[R] without an \f[C]eventtitle\f[R] field (this entry
6147+type will be mapped to CSL \f[C]manuscript\f[R]).
6148+.PP
6149+For a talk, an unpublished conference paper, or a poster presentation,
6150+use the biblatex entry type \f[C]unpublished\f[R] with an
6151+\f[C]eventtitle\f[R] field (this entry type will be mapped to CSL
6152+\f[C]speech\f[R]).
6153+Use the biblatex \f[C]type\f[R] field to indicate the type,
6154+e.g.\ \[lq]Paper\[rq], or \[lq]Poster\[rq].
6155+\f[C]venue\f[R] and \f[C]eventdate\f[R] may be useful too, though
6156+\f[C]eventdate\f[R] will not be rendered by most CSL styles.
6157+Note that \f[C]venue\f[R] is for the event\[cq]s venue, unlike
6158+\f[C]location\f[R] which describes the publisher\[cq]s location; do not
6159+use the latter for an unpublished conference paper.
6160+.SS Specifying a citation style
6161+.PP
6162+Citations and references can be formatted using any style supported by
6163+the Citation Style Language, listed in the Zotero Style Repository.
6164+These files are specified using the \f[C]--csl\f[R] option or the
6165+\f[C]csl\f[R] (or \f[C]citation-style\f[R]) metadata field.
6166+By default, pandoc will use the Chicago Manual of Style author-date
6167+format.
6168+(You can override this default by copying a CSL style of your choice to
6169+\f[C]default.csl\f[R] in your user data directory.) The CSL project
6170+provides further information on finding and editing styles.
6171+.PP
6172+The \f[C]--citation-abbreviations\f[R] option (or the
6173+\f[C]citation-abbreviations\f[R] metadata field) may be used to specify
6174+a JSON file containing abbreviations of journals that should be used in
6175+formatted bibliographies when \f[C]form=\[dq]short\[dq]\f[R] is
6176+specified.
6177+The format of the file can be illustrated with an example:
6178+.IP
6179+.nf
6180+\f[C]
6181+{ \[dq]default\[dq]: {
6182+ \[dq]container-title\[dq]: {
6183+ \[dq]Lloyd\[aq]s Law Reports\[dq]: \[dq]Lloyd\[aq]s Rep\[dq],
6184+ \[dq]Estates Gazette\[dq]: \[dq]EG\[dq],
6185+ \[dq]Scots Law Times\[dq]: \[dq]SLT\[dq]
6186+ }
6187+ }
6188+}
6189+\f[R]
6190+.fi
6191+.SS Raw content in a style
6192+.PP
6193+To include raw content in a prefix, suffix, delimiter, or term, surround
6194+it with these tags indicating the format:
6195+.IP
6196+.nf
6197+\f[C]
6198+{{jats}}<ref>{{/jats}}
6199+\f[R]
6200+.fi
6201+.PP
6202+Without the tags, the string will be interpreted as a string and escaped
6203+in the output, rather than being passed through raw.
6204+.PP
6205+This feature allows stylesheets to be customized to give different
6206+output for different output formats.
6207+However, stylesheets customized in this way will not be useable by other
6208+CSL implementations.
6209+.SS Placement of the bibliography
6210+.PP
6211+If the style calls for a list of works cited, it will be placed in a div
6212+with id \f[C]refs\f[R], if one exists:
6213+.IP
6214+.nf
6215+\f[C]
6216+::: {#refs}
6217+:::
6218+\f[R]
6219+.fi
6220+.PP
6221+Otherwise, it will be placed at the end of the document.
6222+Generation of the bibliography can be suppressed by setting
6223+\f[C]suppress-bibliography: true\f[R] in the YAML metadata.
6224+.PP
6225+If you wish the bibliography to have a section heading, you can set
6226+\f[C]reference-section-title\f[R] in the metadata, or put the heading at
6227+the beginning of the div with id \f[C]refs\f[R] (if you are using it) or
6228+at the end of your document:
6229+.IP
6230+.nf
6231+\f[C]
6232+last paragraph...
6233+
6234+# References
6235+\f[R]
6236+.fi
6237+.PP
6238+The bibliography will be inserted after this heading.
6239+Note that the \f[C]unnumbered\f[R] class will be added to this heading,
6240+so that the section will not be numbered.
6241+.SS Including uncited items in the bibliography
6242+.PP
6243+If you want to include items in the bibliography without actually citing
6244+them in the body text, you can define a dummy \f[C]nocite\f[R] metadata
6245+field and put the citations there:
6246+.IP
6247+.nf
6248+\f[C]
6249+---
6250+nocite: |
6251+ \[at]item1, \[at]item2
6252+\&...
6253+
6254+\[at]item3
6255+\f[R]
6256+.fi
6257+.PP
6258+In this example, the document will contain a citation for
6259+\f[C]item3\f[R] only, but the bibliography will contain entries for
6260+\f[C]item1\f[R], \f[C]item2\f[R], and \f[C]item3\f[R].
6261+.PP
6262+It is possible to create a bibliography with all the citations, whether
6263+or not they appear in the document, by using a wildcard:
6264+.IP
6265+.nf
6266+\f[C]
6267+---
6268+nocite: |
6269+ \[at]*
6270+\&...
6271+\f[R]
6272+.fi
6273+.PP
6274+For LaTeX output, you can also use \f[C]natbib\f[R] or
6275+\f[C]biblatex\f[R] to render the bibliography.
6276+In order to do so, specify bibliography files as outlined above, and add
6277+\f[C]--natbib\f[R] or \f[C]--biblatex\f[R] argument to \f[C]pandoc\f[R]
6278+invocation.
6279+Bear in mind that bibliography files have to be in either BibTeX (for
6280+\f[C]--natbib\f[R]) or BibLaTeX (for \f[C]--biblatex\f[R]) format.
6281+.SS Other relevant metadata fields
6282+.PP
6283+A few other metadata fields affect bibliography formatting:
61026284.TP
6103−\f[B]\f[CB]markdown_phpextra\f[B]\f[R] (PHP Markdown Extra)
6104−\f[C]footnotes\f[R], \f[C]pipe_tables\f[R], \f[C]raw_html\f[R],
6105−\f[C]markdown_attribute\f[R], \f[C]fenced_code_blocks\f[R],
6106−\f[C]definition_lists\f[R], \f[C]intraword_underscores\f[R],
6107−\f[C]header_attributes\f[R], \f[C]link_attributes\f[R],
6108−\f[C]abbreviations\f[R], \f[C]shortcut_reference_links\f[R],
6109−\f[C]spaced_reference_links\f[R].
6110−.TP
6111−\f[B]\f[CB]markdown_github\f[B]\f[R] (deprecated GitHub-Flavored Markdown)
6112−\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],
6113−\f[C]auto_identifiers\f[R], \f[C]gfm_auto_identifiers\f[R],
6114−\f[C]backtick_code_blocks\f[R], \f[C]autolink_bare_uris\f[R],
6115−\f[C]space_in_atx_header\f[R], \f[C]intraword_underscores\f[R],
6116−\f[C]strikeout\f[R], \f[C]task_lists\f[R], \f[C]emoji\f[R],
6117−\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
6118−\f[C]lists_without_preceding_blankline\f[R].
6119−.TP
6120−\f[B]\f[CB]markdown_mmd\f[B]\f[R] (MultiMarkdown)
6121−\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]markdown_attribute\f[R],
6122−\f[C]mmd_link_attributes\f[R], \f[C]tex_math_double_backslash\f[R],
6123−\f[C]intraword_underscores\f[R], \f[C]mmd_title_block\f[R],
6124−\f[C]footnotes\f[R], \f[C]definition_lists\f[R],
6125−\f[C]all_symbols_escapable\f[R], \f[C]implicit_header_references\f[R],
6126−\f[C]auto_identifiers\f[R], \f[C]mmd_header_identifiers\f[R],
6127−\f[C]shortcut_reference_links\f[R], \f[C]implicit_figures\f[R],
6128−\f[C]superscript\f[R], \f[C]subscript\f[R],
6129−\f[C]backtick_code_blocks\f[R], \f[C]spaced_reference_links\f[R],
6130−\f[C]raw_attribute\f[R].
6131−.TP
6132−\f[B]\f[CB]markdown_strict\f[B]\f[R] (Markdown.pl)
6133−\f[C]raw_html\f[R], \f[C]shortcut_reference_links\f[R],
6134−\f[C]spaced_reference_links\f[R].
6135−.PP
6136−We also support \f[C]commonmark\f[R] and \f[C]gfm\f[R] (GitHub-Flavored
6137−Markdown, which is implemented as a set of extensions on
6138−\f[C]commonmark\f[R]).
6139−.PP
6140−Note, however, that \f[C]commonmark\f[R] and \f[C]gfm\f[R] have limited
6141−support for extensions.
6142−Only those listed below (and \f[C]smart\f[R], \f[C]raw_tex\f[R], and
6143−\f[C]hard_line_breaks\f[R]) will work.
6144−The extensions can, however, all be individually disabled.
6145−Also, \f[C]raw_tex\f[R] only affects \f[C]gfm\f[R] output, not input.
6146−.TP
6147−\f[B]\f[CB]gfm\f[B]\f[R] (GitHub-Flavored Markdown)
6148−\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]native_divs\f[R],
6149−\f[C]fenced_code_blocks\f[R], \f[C]auto_identifiers\f[R],
6150−\f[C]gfm_auto_identifiers\f[R], \f[C]backtick_code_blocks\f[R],
6151−\f[C]autolink_bare_uris\f[R], \f[C]space_in_atx_header\f[R],
6152−\f[C]intraword_underscores\f[R], \f[C]strikeout\f[R],
6153−\f[C]task_lists\f[R], \f[C]emoji\f[R],
6154−\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
6155−\f[C]lists_without_preceding_blankline\f[R].
6156−.SH PRODUCING SLIDE SHOWS WITH PANDOC
6285+\f[B]\f[CB]link-citation\f[B]\f[R]
6286+If true, citations will be hyperlinked to the corresponding bibliography
6287+entries (for author-date and numerical styles only).
6288+.TP
6289+\f[B]\f[CB]lang\f[B]\f[R]
6290+The \f[C]lang\f[R] field will affect how the style is localized, for
6291+example in the translation of labels and the use of quotation marks.
6292+(For backwards compatibility, \f[C]locale\f[R] may be used instead of
6293+\f[C]lang\f[R], but this use is deprecated.)
6294+.TP
6295+\f[B]\f[CB]notes-after-punctuation\f[B]\f[R]
6296+If true (the default), pandoc will put footnote citations after
6297+following punctuation.
6298+For example, if the source contains \f[C]blah blah [\[at]jones99].\f[R],
6299+the result will look like \f[C]blah blah.[\[ha]1]\f[R], with the note
6300+moved after the period and the space collapsed.
6301+If false, the space will still be collapsed, but the footnote will not
6302+be moved after the punctuation.
6303+.SH SLIDE SHOWS
61576304.PP
61586305You can use pandoc to produce an HTML + JavaScript slide presentation
61596306that can be viewed via a web browser.
@@ -6162,7 +6309,7 @@ reveal.js.
61626309You can also produce a PDF slide show using LaTeX \f[C]beamer\f[R], or
61636310slides shows in Microsoft PowerPoint format.
61646311.PP
6165−Here\[aq]s the Markdown source for a simple slide show,
6312+Here\[cq]s the Markdown source for a simple slide show,
61666313\f[C]habits.txt\f[R]:
61676314.IP
61686315.nf
@@ -6266,19 +6413,19 @@ Headings \f[I]below\f[R] the slide level in the hierarchy create
62666413headings \f[I]within\f[R] a slide.
62676414.IP \[bu] 2
62686415Headings \f[I]above\f[R] the slide level in the hierarchy create
6269−\[dq]title slides,\[dq] which just contain the section title and help to
6416+\[lq]title slides,\[rq] which just contain the section title and help to
62706417break the slide show into sections.
62716418Non-slide content under these headings will be included on the title
62726419slide (for HTML slide shows) or in a subsequent slide with the same
62736420title (for beamer).
62746421.IP \[bu] 2
6275−A title page is constructed automatically from the document\[aq]s title
6422+A title page is constructed automatically from the document\[cq]s title
62766423block, if present.
62776424(In the case of beamer, this can be disabled by commenting out some
62786425lines in the default template.)
62796426.PP
62806427These rules are designed to support many different styles of slide show.
6281−If you don\[aq]t care about structuring your slides into sections and
6428+If you don\[cq]t care about structuring your slides into sections and
62826429subsections, you can just use level-1 headings for all each slide.
62836430(In that case, level-1 will be the slide level.) But you can also
62846431structure the slide show into sections, as in the example above.
@@ -6290,8 +6437,8 @@ It is not recommended that you use deeper nesting of section levels with
62906437reveal.js.
62916438.SS Incremental lists
62926439.PP
6293−By default, these writers produce lists that display \[dq]all at
6294−once.\[dq] If you want your lists to display incrementally (one item at
6440+By default, these writers produce lists that display \[lq]all at
6441+once.\[rq] If you want your lists to display incrementally (one item at
62956442a time), use the \f[C]-i\f[R] option.
62966443If you want a particular list to depart from the default, put it in a
62976444\f[C]div\f[R] block with class \f[C]incremental\f[R] or
@@ -6344,7 +6491,7 @@ Note: Neither the \f[C]-i/--incremental\f[R] option nor any of the
63446491methods described here currently works for PowerPoint output.
63456492.SS Inserting pauses
63466493.PP
6347−You can add \[dq]pauses\[dq] within a slide by including a paragraph
6494+You can add \[lq]pauses\[rq] within a slide by including a paragraph
63486495containing three dots, separated by spaces:
63496496.IP
63506497.nf
@@ -6367,7 +6514,7 @@ in \f[C]$DATADIR/s5/default\f[R] (for S5), \f[C]$DATADIR/slidy\f[R] (for
63676514Slidy), or \f[C]$DATADIR/slideous\f[R] (for Slideous), where
63686515\f[C]$DATADIR\f[R] is the user data directory (see \f[C]--data-dir\f[R],
63696516above).
6370−The originals may be found in pandoc\[aq]s system data directory
6517+The originals may be found in pandoc\[cq]s system data directory
63716518(generally \f[C]$CABALDIR/pandoc-VERSION/s5/default\f[R]).
63726519Pandoc will look there for any files it does not find in the user data
63736520directory.
@@ -6497,7 +6644,7 @@ contents...
64976644The class \f[C]onlytextwidth\f[R] sets the \f[C]totalwidth\f[R] to
64986645\f[C]\[rs]textwidth\f[R].
64996646.PP
6500−See Section 12.7 of the Beamer User\[aq]s Guide for more details.
6647+See Section 12.7 of the Beamer User\[cq]s Guide for more details.
65016648.SS Frame attributes in beamer
65026649.PP
65036650Sometimes it is necessary to add the LaTeX \f[C][fragile]\f[R] option to
@@ -6513,7 +6660,7 @@ introducing the slide:
65136660.fi
65146661.PP
65156662All of the other frame attributes described in Section 8.1 of the Beamer
6516−User\[aq]s Guide may also be used: \f[C]allowdisplaybreaks\f[R],
6663+User\[cq]s Guide may also be used: \f[C]allowdisplaybreaks\f[R],
65176664\f[C]allowframebreaks\f[R], \f[C]b\f[R], \f[C]c\f[R], \f[C]t\f[R],
65186665\f[C]environment\f[R], \f[C]label\f[R], \f[C]plain\f[R],
65196666\f[C]shrink\f[R], \f[C]standout\f[R], \f[C]noframenumbering\f[R].
@@ -6538,7 +6685,7 @@ To set an image for a particular reveal.js slide, add
65386685\f[C]{data-background-image=\[dq]/path/to/image\[dq]}\f[R] to the first
65396686slide-level heading on the slide (which may even be empty).
65406687.PP
6541−In reveal.js\[aq]s overview mode, the parallaxBackgroundImage will show
6688+In reveal.js\[cq]s overview mode, the parallaxBackgroundImage will show
65426689up only on the first slide.
65436690.PP
65446691Other reveal.js background settings also work on individual slides,
@@ -6574,7 +6721,7 @@ Slide 1 has background_image.png as its background.
65746721Slide 2 has a special image for its background, even though the heading has no content.
65756722\f[R]
65766723.fi
6577−.SH CREATING EPUBS WITH PANDOC
6724+.SH EPUBS
65786725.SS EPUB Metadata
65796726.PP
65806727EPUB metadata may be specified using the \f[C]--epub-metadata\f[R]
@@ -6628,8 +6775,8 @@ Valid values for \f[C]type\f[R] are \f[C]main\f[R], \f[C]subtitle\f[R],
66286775Either a string value, or an object with fields \f[C]role\f[R],
66296776\f[C]file-as\f[R], and \f[C]text\f[R], or a list of such objects.
66306777Valid values for \f[C]role\f[R] are MARC relators, but pandoc will
6631−attempt to translate the human-readable versions (like \[dq]author\[dq]
6632−and \[dq]editor\[dq]) to the appropriate marc relators.
6778+attempt to translate the human-readable versions (like \[lq]author\[rq]
6779+and \[lq]editor\[rq]) to the appropriate marc relators.
66336780.TP
66346781\f[B]\f[CB]contributor\f[B]\f[R]
66356782Same format as \f[C]creator\f[R].
@@ -6818,11 +6965,6 @@ T}@T{
68186965frontmatter
68196966T}
68206967T{
6821−seriespage
6822−T}@T{
6823−frontmatter
6824−T}
6825−T{
68266968appendix
68276969T}@T{
68286970backmatter
@@ -6863,7 +7005,7 @@ For example:
68637005</audio>
68647006\f[R]
68657007.fi
6866−.SH CREATING JUPYTER NOTEBOOKS WITH PANDOC
7008+.SH JUPYTER NOTEBOOKS
68677009.PP
68687010When creating a Jupyter notebook, pandoc will try to infer the notebook
68697011structure.
@@ -6978,7 +7120,7 @@ hello
69787120If you include raw HTML or TeX in an output cell, use the [raw
69797121attribute][Extension: \f[C]fenced_attribute\f[R]], as shown in the last
69807122cell of the example above.
6981−Although pandoc can process \[dq]bare\[dq] raw HTML and TeX, the result
7123+Although pandoc can process \[lq]bare\[rq] raw HTML and TeX, the result
69827124is often interspersed raw elements and normal textual elements, and in
69837125an output cell pandoc expects a single, connected raw block.
69847126To avoid using raw HTML or TeX except when marked explicitly using raw
@@ -7031,10 +7173,10 @@ pandoc --highlight-style my.theme
70317173.fi
70327174.PP
70337175If you are not satisfied with the built-in highlighting, or you want
7034−highlight a language that isn\[aq]t supported, you can use the
7176+highlight a language that isn\[cq]t supported, you can use the
70357177\f[C]--syntax-definition\f[R] option to load a KDE-style XML syntax
70367178definition file.
7037−Before writing your own, have a look at KDE\[aq]s repository of syntax
7179+Before writing your own, have a look at KDE\[cq]s repository of syntax
70387180definitions.
70397181.PP
70407182To disable highlighting, use the \f[C]--no-highlight\f[R] option.
@@ -7043,7 +7185,7 @@ To disable highlighting, use the \f[C]--no-highlight\f[R] option.
70437185Custom styles can be used in the docx and ICML formats.
70447186.SS Output
70457187.PP
7046−By default, pandoc\[aq]s docx and ICML output applies a predefined set
7188+By default, pandoc\[cq]s docx and ICML output applies a predefined set
70477189of styles for blocks such as paragraphs and block quotes, and uses
70487190largely default formatting (italics, bold) for inlines.
70497191This will work for most purposes, especially alongside a
@@ -7064,7 +7206,7 @@ So, for example, using the \f[C]bracketed_spans\f[R] syntax,
70647206\f[R]
70657207.fi
70667208.PP
7067−would produce a docx file with \[dq]Get out\[dq] styled with character
7209+would produce a docx file with \[lq]Get out\[rq] styled with character
70687210style \f[C]Emphatically\f[R].
70697211Similarly, using the \f[C]fenced_divs\f[R] syntax,
70707212.IP
@@ -7095,13 +7237,13 @@ character style (perhaps to change their color), you can write a filter
70957237which will transform all italicized inlines to inlines within an
70967238\f[C]Emphasis\f[R] custom-style \f[C]span\f[R].
70977239.PP
7098−For docx output, you don\[aq]t need to enable any extensions for custom
7240+For docx output, you don\[cq]t need to enable any extensions for custom
70997241styles to work.
71007242.SS Input
71017243.PP
71027244The docx reader, by default, only reads those styles that it can convert
71037245into pandoc elements, either by direct conversion or interpreting the
7104−derivation of the input document\[aq]s styles.
7246+derivation of the input document\[cq]s styles.
71057247.PP
71067248By enabling the \f[C]styles\f[R] extension in the docx reader
71077249(\f[C]-f docx+styles\f[R]), you can produce output that maintains the
@@ -7202,7 +7344,7 @@ fully isolates pandoc from your file system, by running the pandoc
72027344operations in the \f[C]PandocPure\f[R] monad.
72037345See the document Using the pandoc API for more details.
72047346.IP "3." 3
7205−Pandoc\[aq]s parsers can exhibit pathological performance on some corner
7347+Pandoc\[cq]s parsers can exhibit pathological performance on some corner
72067348cases.
72077349It is wise to put any pandoc operations under a timeout, to avoid DOS
72087350attacks that exploit these issues.
@@ -7219,7 +7361,7 @@ To be safe, you should run all the generated HTML through an HTML
72197361sanitizer.
72207362.SH AUTHORS
72217363.PP
7222−Copyright 2006--2020 John MacFarlane (jgm\[at]berkeley.edu).
7364+Copyright 2006\[en]2020 John MacFarlane (jgm\[at]berkeley.edu).
72237365Released under the GPL, version 2 or greater.
72247366This software carries no warranty of any kind.
72257367(See COPYRIGHT for full copyright and warranty notices.) For a full list