@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "September 27, 2018" "pandoc 2.4"
2+.TH PANDOC 1 "November 01, 2018" "pandoc 2.4"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -49,7 +49,7 @@ For output to a file, use the \f[C]\-o\f[R] option:
4949.IP
5050.nf
5151\f[C]
52−pandoc\ \-o\ output.html\ input.txt
52+pandoc \-o output.html input.txt
5353\f[R]
5454.fi
5555.PP
@@ -60,7 +60,7 @@ the \f[C]\-s\f[R] or \f[C]\-\-standalone\f[R] flag:
6060.IP
6161.nf
6262\f[C]
63−pandoc\ \-s\ \-o\ output.html\ input.txt
63+pandoc \-s \-o output.html input.txt
6464\f[R]
6565.fi
6666.PP
@@ -81,7 +81,7 @@ type:
8181.IP
8282.nf
8383\f[C]
84−pandoc\ \-f\ markdown\ \-t\ latex\ hello.txt
84+pandoc \-f markdown \-t latex hello.txt
8585\f[R]
8686.fi
8787.PP
@@ -89,14 +89,14 @@ To convert \f[C]hello.html\f[R] from HTML to Markdown:
8989.IP
9090.nf
9191\f[C]
92−pandoc\ \-f\ html\ \-t\ markdown\ hello.html
92+pandoc \-f html \-t markdown hello.html
9393\f[R]
9494.fi
9595.PP
9696Supported input and output formats are listed below under Options (see
9797\f[C]\-f\f[R] for input formats and \f[C]\-t\f[R] for output formats).
98−You can also use \f[C]pandoc\ \-\-list\-input\-formats\f[R] and
99−\f[C]pandoc\ \-\-list\-output\-formats\f[R] to print lists of supported
98+You can also use \f[C]pandoc \-\-list\-input\-formats\f[R] and
99+\f[C]pandoc \-\-list\-output\-formats\f[R] to print lists of supported
100100formats.
101101.PP
102102If the input or output format is not specified explicitly,
@@ -106,7 +106,7 @@ Thus, for example,
106106.IP
107107.nf
108108\f[C]
109−pandoc\ \-o\ hello.tex\ hello.txt
109+pandoc \-o hello.tex hello.txt
110110\f[R]
111111.fi
112112.PP
@@ -125,7 +125,7 @@ and output through \f[C]iconv\f[R]:
125125.IP
126126.nf
127127\f[C]
128−iconv\ \-t\ utf\-8\ input.txt\ |\ pandoc\ |\ iconv\ \-f\ utf\-8
128+iconv \-t utf\-8 input.txt | pandoc | iconv \-f utf\-8
129129\f[R]
130130.fi
131131.PP
@@ -135,12 +135,12 @@ included in the document header, which will only be included if you use
135135the \f[C]\-s/\-\-standalone\f[R] option.
136136.SS Creating a PDF
137137.PP
138−To produce a PDF, specify an output file with a \f[C]\&.pdf\f[R]
138+To produce a PDF, specify an output file with a \f[C].pdf\f[R]
139139extension:
140140.IP
141141.nf
142142\f[C]
143−pandoc\ test.txt\ \-o\ test.pdf
143+pandoc test.txt \-o test.pdf
144144\f[R]
145145.fi
146146.PP
@@ -150,10 +150,10 @@ a LaTeX engine be installed (see \f[C]\-\-pdf\-engine\f[R] below).
150150Alternatively, pandoc can use ConTeXt, \f[C]pdfroff\f[R], or any of the
151151following HTML/CSS\-to\-PDF\-engines, to create a PDF:
152152\f[C]wkhtmltopdf\f[R], \f[C]weasyprint\f[R] or \f[C]prince\f[R].
153−To do this, specify an output file with a \f[C]\&.pdf\f[R] extension, as
153+To do this, specify an output file with a \f[C].pdf\f[R] extension, as
154154before, but add the \f[C]\-\-pdf\-engine\f[R] option or
155−\f[C]\-t\ context\f[R], \f[C]\-t\ html\f[R], or \f[C]\-t\ ms\f[R] to the
156−command line (\f[C]\-t\ html\f[R] defaults to
155+\f[C]\-t context\f[R], \f[C]\-t html\f[R], or \f[C]\-t ms\f[R] to the
156+command line (\f[C]\-t html\f[R] defaults to
157157\f[C]\-\-pdf\-engine=wkhtmltopdf\f[R]).
158158.PP
159159PDF output can be controlled using variables for LaTeX (if LaTeX is
@@ -166,9 +166,9 @@ If \f[C]wkhtmltopdf\f[R] is used, then the variables
166166and \f[C]papersize\f[R] will affect the output.
167167.PP
168168To debug the PDF creation, it can be useful to look at the intermediate
169−representation: instead of \f[C]\-o\ test.pdf\f[R], use for example
170−\f[C]\-s\ \-o\ test.tex\f[R] to output the generated LaTeX.
171−You can then test it with \f[C]pdflatex\ test.tex\f[R].
169+representation: instead of \f[C]\-o test.pdf\f[R], use for example
170+\f[C]\-s \-o test.tex\f[R] to output the generated LaTeX.
171+You can then test it with \f[C]pdflatex test.tex\f[R].
172172.PP
173173When using LaTeX, the following packages need to be available (they are
174174included with all recent versions of TeX Live): \f[C]amsfonts\f[R],
@@ -201,7 +201,7 @@ In this case pandoc will fetch the content using HTTP:
201201.IP
202202.nf
203203\f[C]
204−pandoc\ \-f\ html\ \-t\ markdown\ http://www.fsf.org
204+pandoc \-f html \-t markdown http://www.fsf.org
205205\f[R]
206206.fi
207207.PP
@@ -210,8 +210,8 @@ when requesting a document from a URL:
210210.IP
211211.nf
212212\f[C]
213−pandoc\ \-f\ html\ \-t\ markdown\ \-\-request\-header\ User\-Agent:\[dq]Mozilla/5.0\[dq]\ \[rs]
214−\ \ http://www.fsf.org
213+pandoc \-f html \-t markdown \-\-request\-header User\-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
214+ http://www.fsf.org
215215\f[R]
216216.fi
217217.SH OPTIONS
@@ -333,7 +333,7 @@ HTML5/XHTML polyglot markup)
333333.IP \[bu] 2
334334\f[C]latex\f[R] (LaTeX)
335335.IP \[bu] 2
336−\f[C]man\f[R] (groff man)
336+\f[C]man\f[R] (roff man)
337337.IP \[bu] 2
338338\f[C]markdown\f[R] (Pandoc\[aq]s Markdown)
339339.IP \[bu] 2
@@ -345,7 +345,7 @@ HTML5/XHTML polyglot markup)
345345.IP \[bu] 2
346346\f[C]mediawiki\f[R] (MediaWiki markup)
347347.IP \[bu] 2
348−\f[C]ms\f[R] (groff ms)
348+\f[C]ms\f[R] (roff ms)
349349.IP \[bu] 2
350350\f[C]muse\f[R] (Muse),
351351.IP \[bu] 2
@@ -388,8 +388,7 @@ HTML5/XHTML polyglot markup)
388388the path of a custom lua writer, see Custom writers below
389389.PP
390390Note that \f[C]odt\f[R], \f[C]docx\f[R], and \f[C]epub\f[R] output will
391−not be directed to \f[I]stdout\f[R] unless forced with
392−\f[C]\-o\ \-\f[R].
391+not be directed to \f[I]stdout\f[R] unless forced with \f[C]\-o \-\f[R].
393392.PP
394393Extensions can be individually enabled or disabled by appending
395394\f[C]+EXTENSION\f[R] or \f[C]\-EXTENSION\f[R] to the format name.
@@ -421,7 +420,7 @@ in Windows XP:
421420.IP
422421.nf
423422\f[C]
424−C:\[rs]Documents\ And\ Settings\[rs]USERNAME\[rs]Application\ Data\[rs]pandoc
423+C:\[rs]Documents And Settings\[rs]USERNAME\[rs]Application Data\[rs]pandoc
425424\f[R]
426425.fi
427426.PP
@@ -434,7 +433,7 @@ C:\[rs]Users\[rs]USERNAME\[rs]AppData\[rs]Roaming\[rs]pandoc
434433.fi
435434.PP
436435You can find the default user data directory on your system by looking
437−at the output of \f[C]pandoc\ \-\-version\f[R].
436+at the output of \f[C]pandoc \-\-version\f[R].
438437A \f[C]reference.odt\f[R], \f[C]reference.docx\f[R], \f[C]epub.css\f[R],
439438\f[C]templates\f[R], \f[C]slidy\f[R], \f[C]slideous\f[R], or
440439\f[C]s5\f[R] directory placed in this directory will override
@@ -444,12 +443,12 @@ pandoc\[aq]s normal defaults.
444443.B \f[C]\-\-bash\-completion\f[R]
445444Generate a bash completion script.
446445To enable bash completion with pandoc, add this to your
447−\f[C]\&.bashrc\f[R]:
446+\f[C].bashrc\f[R]:
448447.RS
449448.IP
450449.nf
451450\f[C]
452−eval\ \[dq]$(pandoc\ \-\-bash\-completion)\[dq]
451+eval \[dq]$(pandoc \-\-bash\-completion)\[dq]
453452\f[R]
454453.fi
455454.RE
@@ -537,7 +536,7 @@ Hence,
537536.IP
538537.nf
539538\f[C]
540−pandoc\ \-\-filter\ ./caps.py\ \-t\ latex
539+pandoc \-\-filter ./caps.py \-t latex
541540\f[R]
542541.fi
543542.PP
@@ -545,7 +544,7 @@ is equivalent to
545544.IP
546545.nf
547546\f[C]
548−pandoc\ \-t\ json\ |\ ./caps.py\ latex\ |\ pandoc\ \-f\ json\ \-t\ latex
547+pandoc \-t json | ./caps.py latex | pandoc \-f json \-t latex
549548\f[R]
550549.fi
551550.PP
@@ -592,15 +591,15 @@ The following is an example lua script for macro\-expansion:
592591.IP
593592.nf
594593\f[C]
595−function\ expand_hello_world(inline)
596−\ \ if\ inline.c\ ==\ \[aq]{{helloworld}}\[aq]\ then
597−\ \ \ \ return\ pandoc.Emph{\ pandoc.Str\ \[dq]Hello,\ World\[dq]\ }
598−\ \ else
599−\ \ \ \ return\ inline
600−\ \ end
594+function expand_hello_world(inline)
595+ if inline.c == \[aq]{{helloworld}}\[aq] then
596+ return pandoc.Emph{ pandoc.Str \[dq]Hello, World\[dq] }
597+ else
598+ return inline
599+ end
601600end
602601
603−return\ {{Str\ =\ expand_hello_world}}
602+return {{Str = expand_hello_world}}
604603\f[R]
605604.fi
606605.PP
@@ -680,7 +679,7 @@ If this option is not specified, pandoc will read the data file
680679\f[C]abbreviations\f[R] from the user data directory or fall back on a
681680system default.
682681To see the system default, use
683−\f[C]pandoc\ \-\-print\-default\-data\-file=abbreviations\f[R].
682+\f[C]pandoc \-\-print\-default\-data\-file=abbreviations\f[R].
684683The only use pandoc makes of this list is in the Markdown reader.
685684Strings ending in a period that are found in this list will be followed
686685by a nonbreaking space, so that the period will not produce
@@ -795,7 +794,7 @@ See also \f[C]\-\-list\-highlight\-styles\f[R].
795794.RS
796795.PP
797796Instead of a \f[I]STYLE\f[R] name, a JSON file with extension
798−\f[C]\&.theme\f[R] may be supplied.
797+\f[C].theme\f[R] may be supplied.
799798This will be parsed as a KDE syntax highlighting theme and (if valid)
800799used as the highlighting style.
801800.PP
@@ -805,7 +804,7 @@ To generate the JSON version of an existing style, use
805804.TP
806805.B \f[C]\-\-print\-highlight\-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
807806Prints a JSON version of a highlighting style, which can be modified,
808−saved with a \f[C]\&.theme\f[R] extension, and used with
807+saved with a \f[C].theme\f[R] extension, and used with
809808\f[C]\-\-highlight\-style\f[R].
810809.TP
811810.B \f[C]\-\-syntax\-definition=\f[R]\f[I]FILE\f[R]
@@ -898,11 +897,11 @@ Use \f[C]<q>\f[R] tags for quotes in HTML.
898897.TP
899898.B \f[C]\-\-ascii\f[R]
900899Use only ASCII characters in output.
901−Currently supported for XML and HTML formats (which use numerical
902−entities instead of UTF\-8 when this option is selected), groff ms
903−(which use hexadecimal escapes), and to a limited degree LaTeX (which
904−uses standard commands for accented characters when possible).
905−Groff man output uses ASCII by default.
900+Currently supported for XML and HTML formats (which use entities instead
901+of UTF\-8 when this option is selected), Markdown (which uses entities),
902+roff ms (which use hexadecimal escapes), and to a limited degree LaTeX
903+(which uses standard commands for accented characters when possible).
904+roff man output uses ASCII by default.
906905.TP
907906.B \f[C]\-\-reference\-links\f[R]
908907Use reference\-style links, rather than inline links, in writing
@@ -911,7 +910,7 @@ By default inline links are used.
911910The placement of link references is affected by the
912911\f[C]\-\-reference\-location\f[R] option.
913912.TP
914−.B \f[C]\-\-reference\-location\ =\ block\f[R]|\f[C]section\f[R]|\f[C]document\f[R]
913+.B \f[C]\-\-reference\-location = block\f[R]|\f[C]section\f[R]|\f[C]document\f[R]
915914Specify whether footnotes (and references, if \f[C]reference\-links\f[R]
916915is set) are placed at the end of the current (top\-level) block, the
917916current section, or the document.
@@ -1017,9 +1016,10 @@ They will be included in the order specified.
10171016.RS
10181017.PP
10191018A stylesheet is required for generating EPUB.
1020−If none is provided using this option (or the \f[C]stylesheet\f[R]
1021−metadata field), pandoc will look for a file \f[C]epub.css\f[R] in the
1022−user data directory (see \f[C]\-\-data\-dir\f[R]).
1019+If none is provided using this option (or the \f[C]css\f[R] or
1020+\f[C]stylesheet\f[R] metadata fields), pandoc will look for a file
1021+\f[C]epub.css\f[R] in the user data directory (see
1022+\f[C]\-\-data\-dir\f[R]).
10231023If it is not found there, sensible defaults will be used.
10241024.RE
10251025.TP
@@ -1042,7 +1042,7 @@ If this is not found either, sensible defaults will be used.
10421042.PP
10431043To produce a custom \f[C]reference.docx\f[R], first get a copy of the
10441044default \f[C]reference.docx\f[R]:
1045−\f[C]pandoc\ \-\-print\-default\-data\-file\ reference.docx\ >\ custom\-reference.docx\f[R].
1045+\f[C]pandoc \-\-print\-default\-data\-file reference.docx > custom\-reference.docx\f[R].
10461046Then open \f[C]custom\-reference.docx\f[R] in Word, modify the styles as
10471047you wish, and save the file.
10481048For best results, do not make changes to this file other than modifying
@@ -1069,15 +1069,15 @@ If this is not found either, sensible defaults will be used.
10691069.PP
10701070To produce a custom \f[C]reference.odt\f[R], first get a copy of the
10711071default \f[C]reference.odt\f[R]:
1072−\f[C]pandoc\ \-\-print\-default\-data\-file\ reference.odt\ >\ custom\-reference.odt\f[R].
1072+\f[C]pandoc \-\-print\-default\-data\-file reference.odt > custom\-reference.odt\f[R].
10731073Then open \f[C]custom\-reference.odt\f[R] in LibreOffice, modify the
10741074styles as you wish, and save the file.
10751075.RE
10761076.TP
10771077.B PowerPoint
10781078Any template included with a recent install of Microsoft PowerPoint
1079−(either with \f[C]\&.pptx\f[R] or \f[C]\&.potx\f[R] extension) should
1080−work, as will most templates derived from these.
1079+(either with \f[C].pptx\f[R] or \f[C].potx\f[R] extension) should work,
1080+as will most templates derived from these.
10811081.RS
10821082.PP
10831083The specific requirement is that the template should contain the
@@ -1097,7 +1097,7 @@ these criteria.
10971097check.)
10981098.PP
10991099You can also modify the default \f[C]reference.pptx\f[R]: first run
1100−\f[C]pandoc\ \-\-print\-default\-data\-file\ reference.pptx\ >\ custom\-reference.pptx\f[R],
1100+\f[C]pandoc \-\-print\-default\-data\-file reference.pptx > custom\-reference.pptx\f[R],
11011101and then modify \f[C]custom\-reference.pptx\f[R] in MS PowerPoint
11021102(pandoc will use the first four layout slides, as mentioned above).
11031103.RE
@@ -1119,8 +1119,8 @@ For example:
11191119.IP
11201120.nf
11211121\f[C]
1122−\ <dc:rights>Creative\ Commons</dc:rights>
1123−\ <dc:language>es\-AR</dc:language>
1122+ <dc:rights>Creative Commons</dc:rights>
1123+ <dc:language>es\-AR</dc:language>
11241124\f[R]
11251125.fi
11261126.PP
@@ -1129,7 +1129,7 @@ By default, pandoc will include the following metadata elements:
11291129(from the document authors), \f[C]<dc:date>\f[R] (from the document
11301130date, which should be in ISO 8601 format), \f[C]<dc:language>\f[R] (from
11311131the \f[C]lang\f[R] variable, or, if is not set, the locale), and
1132−\f[C]<dc:identifier\ id=\[dq]BookId\[dq]>\f[R] (a randomly generated
1132+\f[C]<dc:identifier id=\[dq]BookId\[dq]>\f[R] (a randomly generated
11331133UUID).
11341134Any of these may be overridden by elements in the metadata file.
11351135.PP
@@ -1151,31 +1151,31 @@ following to your CSS (see \f[C]\-\-css\f[R]):
11511151.IP
11521152.nf
11531153\f[C]
1154−\[at]font\-face\ {
1155−font\-family:\ DejaVuSans;
1156−font\-style:\ normal;
1157−font\-weight:\ normal;
1154+\[at]font\-face {
1155+font\-family: DejaVuSans;
1156+font\-style: normal;
1157+font\-weight: normal;
11581158src:url(\[dq]DejaVuSans\-Regular.ttf\[dq]);
11591159}
1160−\[at]font\-face\ {
1161−font\-family:\ DejaVuSans;
1162−font\-style:\ normal;
1163−font\-weight:\ bold;
1160+\[at]font\-face {
1161+font\-family: DejaVuSans;
1162+font\-style: normal;
1163+font\-weight: bold;
11641164src:url(\[dq]DejaVuSans\-Bold.ttf\[dq]);
11651165}
1166−\[at]font\-face\ {
1167−font\-family:\ DejaVuSans;
1168−font\-style:\ italic;
1169−font\-weight:\ normal;
1166+\[at]font\-face {
1167+font\-family: DejaVuSans;
1168+font\-style: italic;
1169+font\-weight: normal;
11701170src:url(\[dq]DejaVuSans\-Oblique.ttf\[dq]);
11711171}
1172−\[at]font\-face\ {
1173−font\-family:\ DejaVuSans;
1174−font\-style:\ italic;
1175−font\-weight:\ bold;
1172+\[at]font\-face {
1173+font\-family: DejaVuSans;
1174+font\-style: italic;
1175+font\-weight: bold;
11761176src:url(\[dq]DejaVuSans\-BoldOblique.ttf\[dq]);
11771177}
1178−body\ {\ font\-family:\ \[dq]DejaVuSans\[dq];\ }
1178+body { font\-family: \[dq]DejaVuSans\[dq]; }
11791179\f[R]
11801180.fi
11811181.RE
@@ -1215,24 +1215,24 @@ Set the \f[C]bibliography\f[R] field in the document\[aq]s metadata to
12151215\f[I]FILE\f[R], overriding any value set in the metadata, and process
12161216citations using \f[C]pandoc\-citeproc\f[R].
12171217(This is equivalent to
1218−\f[C]\-\-metadata\ bibliography=FILE\ \-\-filter\ pandoc\-citeproc\f[R].)
1218+\f[C]\-\-metadata bibliography=FILE \-\-filter pandoc\-citeproc\f[R].)
12191219If \f[C]\-\-natbib\f[R] or \f[C]\-\-biblatex\f[R] is also supplied,
12201220\f[C]pandoc\-citeproc\f[R] is not used, making this equivalent to
1221−\f[C]\-\-metadata\ bibliography=FILE\f[R].
1221+\f[C]\-\-metadata bibliography=FILE\f[R].
12221222If you supply this argument multiple times, each \f[I]FILE\f[R] will be
12231223added to bibliography.
12241224.TP
12251225.B \f[C]\-\-csl=\f[R]\f[I]FILE\f[R]
12261226Set the \f[C]csl\f[R] field in the document\[aq]s metadata to
12271227\f[I]FILE\f[R], overriding any value set in the metadata.
1228−(This is equivalent to \f[C]\-\-metadata\ csl=FILE\f[R].) This option is
1228+(This is equivalent to \f[C]\-\-metadata csl=FILE\f[R].) This option is
12291229only relevant with \f[C]pandoc\-citeproc\f[R].
12301230.TP
12311231.B \f[C]\-\-citation\-abbreviations=\f[R]\f[I]FILE\f[R]
12321232Set the \f[C]citation\-abbreviations\f[R] field in the document\[aq]s
12331233metadata to \f[I]FILE\f[R], overriding any value set in the metadata.
12341234(This is equivalent to
1235−\f[C]\-\-metadata\ citation\-abbreviations=FILE\f[R].) This option is
1235+\f[C]\-\-metadata citation\-abbreviations=FILE\f[R].) This option is
12361236only relevant with \f[C]pandoc\-citeproc\f[R].
12371237.TP
12381238.B \f[C]\-\-natbib\f[R]
@@ -1282,7 +1282,7 @@ Convert TeX formulas to \f[C]<img>\f[R] tags that link to an external
12821282script that converts formulas to images.
12831283The formula will be URL\-encoded and concatenated with the URL provided.
12841284For SVG images you can for example use
1285−\f[C]\-\-webtex\ https://latex.codecogs.com/svg.latex?\f[R].
1285+\f[C]\-\-webtex https://latex.codecogs.com/svg.latex?\f[R].
12861286If no URL is specified, the CodeCogs URL generating PNGs will be used
12871287(\f[C]https://latex.codecogs.com/png.latex?\f[R]).
12881288Note: the \f[C]\-\-webtex\f[R] option will affect Markdown output as
@@ -1306,9 +1306,9 @@ So, the procedure is:
13061306.IP
13071307.nf
13081308\f[C]
1309−pandoc\ \-s\ \-\-gladtex\ input.md\ \-o\ myfile.htex
1310−gladtex\ \-d\ myfile\-images\ myfile.htex
1311−#\ produces\ myfile.html\ and\ images\ in\ myfile\-images
1309+pandoc \-s \-\-gladtex input.md \-o myfile.htex
1310+gladtex \-d myfile\-images myfile.htex
1311+# produces myfile.html and images in myfile\-images
13121312\f[R]
13131313.fi
13141314.RE
@@ -1335,7 +1335,7 @@ Thus, for example,
13351335.IP
13361336.nf
13371337\f[C]
1338−pandoc\ \-\-ignore\-args\ \-o\ foo.html\ \-s\ foo.txt\ \-\-\ \-e\ latin1
1338+pandoc \-\-ignore\-args \-o foo.html \-s foo.txt \-\- \-e latin1
13391339\f[R]
13401340.fi
13411341.PP
@@ -1343,7 +1343,7 @@ is equivalent to
13431343.IP
13441344.nf
13451345\f[C]
1346−pandoc\ \-o\ foo.html\ \-s
1346+pandoc \-o foo.html \-s
13471347\f[R]
13481348.fi
13491349.RE
@@ -1356,7 +1356,7 @@ To see the default template that is used, just type
13561356.IP
13571357.nf
13581358\f[C]
1359−pandoc\ \-D\ *FORMAT*
1359+pandoc \-D *FORMAT*
13601360\f[R]
13611361.fi
13621362.PP
@@ -1374,9 +1374,9 @@ template.
13741374.IP \[bu] 2
13751375For \f[C]pdf\f[R] output, customize the \f[C]default.latex\f[R] template
13761376(or the \f[C]default.context\f[R] template, if you use
1377−\f[C]\-t\ context\f[R], or the \f[C]default.ms\f[R] template, if you use
1378−\f[C]\-t\ ms\f[R], or the \f[C]default.html\f[R] template, if you use
1379−\f[C]\-t\ html\f[R]).
1377+\f[C]\-t context\f[R], or the \f[C]default.ms\f[R] template, if you use
1378+\f[C]\-t ms\f[R], or the \f[C]default.html\f[R] template, if you use
1379+\f[C]\-t html\f[R]).
13801380.IP \[bu] 2
13811381\f[C]docx\f[R] has no template (however, you can use
13821382\f[C]\-\-reference\-doc\f[R] to customize the output).
@@ -1428,8 +1428,8 @@ authors, or through a YAML metadata block:
14281428\f[C]
14291429\-\-\-
14301430author:
1431−\-\ Aristotle
1432−\-\ Peter\ Abelard
1431+\- Aristotle
1432+\- Peter Abelard
14331433\&...
14341434\f[R]
14351435.fi
@@ -1840,7 +1840,7 @@ the boolean \f[C]true\f[R] (to specify the boolean \f[C]true\f[R] value
18401840using YAML metadata or the \f[C]\-\-metadata\f[R] flag, use
18411841\f[C]true\f[R], \f[C]True\f[R], or \f[C]TRUE\f[R]; with the
18421842\f[C]\-\-variable\f[R] flag, simply omit a value for the variable, e.g.
1843−\f[C]\-\-variable\ draft\f[R]).
1843+\f[C]\-\-variable draft\f[R]).
18441844.PP
18451845\f[C]X\f[R] and \f[C]Y\f[R] are placeholders for any valid template
18461846text, and may include interpolated variables or other conditionals.
@@ -1852,7 +1852,7 @@ in a multi\-author document), you can use the \f[C]$for$\f[R] keyword:
18521852.nf
18531853\f[C]
18541854$for(author)$
1855−<meta\ name=\[dq]author\[dq]\ content=\[dq]$author$\[dq]\ />
1855+<meta name=\[dq]author\[dq] content=\[dq]$author$\[dq] />
18561856$endfor$
18571857\f[R]
18581858.fi
@@ -1862,7 +1862,7 @@ items:
18621862.IP
18631863.nf
18641864\f[C]
1865−$for(author)$$author$$sep$,\ $endfor$
1865+$for(author)$$author$$sep$, $endfor$
18661866\f[R]
18671867.fi
18681868.PP
@@ -1872,7 +1872,7 @@ So, for example:
18721872.IP
18731873.nf
18741874\f[C]
1875−$author.name$\ ($author.affiliation$)
1875+$author.name$ ($author.affiliation$)
18761876\f[R]
18771877.fi
18781878.PP
@@ -1892,9 +1892,9 @@ enabling or disabling various extensions.
18921892.PP
18931893An extension can be enabled by adding \f[C]+EXTENSION\f[R] to the format
18941894name and disabled by adding \f[C]\-EXTENSION\f[R].
1895−For example, \f[C]\-\-from\ markdown_strict+footnotes\f[R] is strict
1895+For example, \f[C]\-\-from markdown_strict+footnotes\f[R] is strict
18961896Markdown with footnotes enabled, while
1897−\f[C]\-\-from\ markdown\-footnotes\-pipe_tables\f[R] is pandoc\[aq]s
1897+\f[C]\-\-from markdown\-footnotes\-pipe_tables\f[R] is pandoc\[aq]s
18981898Markdown without footnotes or pipe tables.
18991899.PP
19001900The markdown reader and writer make by far the most use of extensions.
@@ -1906,8 +1906,7 @@ that also work for other formats are covered.
19061906.SS Extension: \f[C]smart\f[R]
19071907.PP
19081908Interpret straight quotes as curly quotes, \f[C]\-\-\-\f[R] as
1909−em\-dashes, \f[C]\-\-\f[R] as en\-dashes, and \f[C]\&...\f[R] as
1910−ellipses.
1909+em\-dashes, \f[C]\-\-\f[R] as en\-dashes, and \f[C]...\f[R] as ellipses.
19111910Nonbreaking spaces are inserted after certain abbreviations, such as
19121911\[dq]Mr.\[dq]
19131912.PP
@@ -1985,22 +1984,22 @@ Identifier
19851984T}
19861985_
19871986T{
1988−\f[C]Header\ identifiers\ in\ HTML\f[R]
1987+\f[C]Header identifiers in HTML\f[R]
19891988T}@T{
19901989\f[C]header\-identifiers\-in\-html\f[R]
19911990T}
19921991T{
1993−\f[C]*Dogs*?\-\-in\ *my*\ house?\f[R]
1992+\f[C]*Dogs*?\-\-in *my* house?\f[R]
19941993T}@T{
19951994\f[C]dogs\-\-in\-my\-house\f[R]
19961995T}
19971996T{
1998−\f[C][HTML],\ [S5],\ or\ [RTF]?\f[R]
1997+\f[C][HTML], [S5], or [RTF]?\f[R]
19991998T}@T{
20001999\f[C]html\-s5\-or\-rtf\f[R]
20012000T}
20022001T{
2003−\f[C]3.\ Applications\f[R]
2002+\f[C]3. Applications\f[R]
20042003T}@T{
20052004\f[C]applications\f[R]
20062005T}
@@ -2027,8 +2026,8 @@ A link to this section, for example, might look like this:
20272026.IP
20282027.nf
20292028\f[C]
2030−See\ the\ section\ on
2031−[header\ identifiers](#header\-identifiers\-in\-html\-latex\-and\-context).
2029+See the section on
2030+[header identifiers](#header\-identifiers\-in\-html\-latex\-and\-context).
20322031\f[R]
20332032.fi
20342033.PP
@@ -2086,14 +2085,14 @@ addition to \f[C]markdown\f[R]):
20862085This extension is enabled by default for HTML input.
20872086This means that \f[C]div\f[R]s are parsed to pandoc native elements.
20882087(Alternatively, you can parse them to raw HTML using
2089−\f[C]\-f\ html\-native_divs+raw_html\f[R].)
2088+\f[C]\-f html\-native_divs+raw_html\f[R].)
20902089.PP
20912090When converting HTML to Markdown, for example, you may want to drop all
20922091\f[C]div\f[R]s and \f[C]span\f[R]s:
20932092.IP
20942093.nf
20952094\f[C]
2096−pandoc\ \-f\ html\-native_divs\-native_spans\ \-t\ markdown
2095+pandoc \-f html\-native_divs\-native_spans \-t markdown
20972096\f[R]
20982097.fi
20992098.SS Extension: \f[C]native_spans\f[R]
@@ -2152,7 +2151,7 @@ Examples:
21522151.IP
21532152.nf
21542153\f[C]
2155−pandoc\ \-f\ markdown+lhs\ \-t\ html
2154+pandoc \-f markdown+lhs \-t html
21562155\f[R]
21572156.fi
21582157.PP
@@ -2161,7 +2160,7 @@ writes ordinary HTML (without bird tracks).
21612160.IP
21622161.nf
21632162\f[C]
2164−pandoc\ \-f\ markdown+lhs\ \-t\ html+lhs
2163+pandoc \-f markdown+lhs \-t html+lhs
21652164\f[R]
21662165.fi
21672166.PP
@@ -2268,10 +2267,10 @@ a level two header):
22682267.IP
22692268.nf
22702269\f[C]
2271−A\ level\-one\ header
2270+A level\-one header
22722271==================
22732272
2274−A\ level\-two\ header
2273+A level\-two header
22752274\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
22762275\f[R]
22772276.fi
@@ -2287,9 +2286,9 @@ header level:
22872286.IP
22882287.nf
22892288\f[C]
2290−##\ A\ level\-two\ header
2289+## A level\-two header
22912290
2292−###\ A\ level\-three\ header\ ###
2291+### A level\-three header ###
22932292\f[R]
22942293.fi
22952294.PP
@@ -2297,7 +2296,7 @@ As with setext\-style headers, the header text can contain formatting:
22972296.IP
22982297.nf
22992298\f[C]
2300−#\ A\ level\-one\ header\ with\ a\ [link](/url)\ and\ *emphasis*
2299+# A level\-one header with a [link](/url) and *emphasis*
23012300\f[R]
23022301.fi
23032302.SS Extension: \f[C]blank_before_header\f[R]
@@ -2312,15 +2311,15 @@ Consider, for example:
23122311.IP
23132312.nf
23142313\f[C]
2315−I\ like\ several\ of\ their\ flavors\ of\ ice\ cream:
2316−#22,\ for\ example,\ and\ #5.
2314+I like several of their flavors of ice cream:
2315+#22, for example, and #5.
23172316\f[R]
23182317.fi
23192318.SS Extension: \f[C]space_in_atx_header\f[R]
23202319.PP
23212320Many Markdown implementations do not require a space between the opening
23222321\f[C]#\f[R]s of an ATX header and the header text, so that
2323−\f[C]#5\ bolt\f[R] and \f[C]#hashtag\f[R] count as headers.
2322+\f[C]#5 bolt\f[R] and \f[C]#hashtag\f[R] count as headers.
23242323With this extension, pandoc does require the space.
23252324.SS Header identifiers
23262325.PP
@@ -2332,7 +2331,7 @@ line containing the header text:
23322331.IP
23332332.nf
23342333\f[C]
2335−{#identifier\ .class\ .class\ key=value\ key=value}
2334+{#identifier .class .class key=value key=value}
23362335\f[R]
23372336.fi
23382337.PP
@@ -2341,11 +2340,11 @@ identifier \f[C]foo\f[R]:
23412340.IP
23422341.nf
23432342\f[C]
2344−#\ My\ header\ {#foo}
2343+# My header {#foo}
23452344
2346−##\ My\ header\ ##\ \ \ \ {#foo}
2345+## My header ## {#foo}
23472346
2348−My\ other\ header\ \ \ {#foo}
2347+My other header {#foo}
23492348\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
23502349\f[R]
23512350.fi
@@ -2363,12 +2362,12 @@ Textile, and AsciiDoc writers.
23632362Headers with the class \f[C]unnumbered\f[R] will not be numbered, even
23642363if \f[C]\-\-number\-sections\f[R] is specified.
23652364A single hyphen (\f[C]\-\f[R]) in an attribute context is equivalent to
2366−\f[C]\&.unnumbered\f[R], and preferable in non\-English documents.
2365+\f[C].unnumbered\f[R], and preferable in non\-English documents.
23672366So,
23682367.IP
23692368.nf
23702369\f[C]
2371−#\ My\ header\ {\-}
2370+# My header {\-}
23722371\f[R]
23732372.fi
23742373.PP
@@ -2376,7 +2375,7 @@ is just the same as
23762375.IP
23772376.nf
23782377\f[C]
2379−#\ My\ header\ {.unnumbered}
2378+# My header {.unnumbered}
23802379\f[R]
23812380.fi
23822381.SS Extension: \f[C]implicit_header_references\f[R]
@@ -2386,7 +2385,7 @@ So, to link to a header
23862385.IP
23872386.nf
23882387\f[C]
2389−#\ Header\ identifiers\ in\ HTML
2388+# Header identifiers in HTML
23902389\f[R]
23912390.fi
23922391.PP
@@ -2394,7 +2393,7 @@ you can simply write
23942393.IP
23952394.nf
23962395\f[C]
2397−[Header\ identifiers\ in\ HTML]
2396+[Header identifiers in HTML]
23982397\f[R]
23992398.fi
24002399.PP
@@ -2402,7 +2401,7 @@ or
24022401.IP
24032402.nf
24042403\f[C]
2405−[Header\ identifiers\ in\ HTML][]
2404+[Header identifiers in HTML][]
24062405\f[R]
24072406.fi
24082407.PP
@@ -2410,7 +2409,7 @@ or
24102409.IP
24112410.nf
24122411\f[C]
2413−[the\ section\ on\ header\ identifiers][header\ identifiers\ in
2412+[the section on header identifiers][header identifiers in
24142413HTML]
24152414\f[R]
24162415.fi
@@ -2419,7 +2418,7 @@ instead of giving the identifier explicitly:
24192418.IP
24202419.nf
24212420\f[C]
2422−[Header\ identifiers\ in\ HTML](#header\-identifiers\-in\-html)
2421+[Header identifiers in HTML](#header\-identifiers\-in\-html)
24232422\f[R]
24242423.fi
24252424.PP
@@ -2436,11 +2435,11 @@ to \f[C]#foo\f[R]:
24362435.IP
24372436.nf
24382437\f[C]
2439−#\ Foo
2438+# Foo
24402439
2441−[foo]:\ bar
2440+[foo]: bar
24422441
2443−See\ [foo]
2442+See [foo]
24442443\f[R]
24452444.fi
24462445.SS Block quotations
@@ -2454,11 +2453,11 @@ indented more than three spaces.)
24542453.IP
24552454.nf
24562455\f[C]
2457−>\ This\ is\ a\ block\ quote.\ This
2458−>\ paragraph\ has\ two\ lines.
2456+> This is a block quote. This
2457+> paragraph has two lines.
24592458>
2460−>\ 1.\ This\ is\ a\ list\ inside\ a\ block\ quote.
2461−>\ 2.\ Second\ item.
2459+> 1. This is a list inside a block quote.
2460+> 2. Second item.
24622461\f[R]
24632462.fi
24642463.PP
@@ -2467,11 +2466,11 @@ the first line of each block, is also allowed:
24672466.IP
24682467.nf
24692468\f[C]
2470−>\ This\ is\ a\ block\ quote.\ This
2471−paragraph\ has\ two\ lines.
2469+> This is a block quote. This
2470+paragraph has two lines.
24722471
2473−>\ 1.\ This\ is\ a\ list\ inside\ a\ block\ quote.
2474−2.\ Second\ item.
2472+> 1. This is a list inside a block quote.
2473+2. Second item.
24752474\f[R]
24762475.fi
24772476.PP
@@ -2481,9 +2480,9 @@ That is, block quotes can be nested:
24812480.IP
24822481.nf
24832482\f[C]
2484−>\ This\ is\ a\ block\ quote.
2483+> This is a block quote.
24852484>
2486−>\ >\ A\ block\ quote\ within\ a\ block\ quote.
2485+> > A block quote within a block quote.
24872486\f[R]
24882487.fi
24892488.PP
@@ -2495,7 +2494,7 @@ spaces after the \f[C]>\f[R]:
24952494.IP
24962495.nf
24972496\f[C]
2498−>\ \ \ \ \ code
2497+> code
24992498\f[R]
25002499.fi
25012500.SS Extension: \f[C]blank_before_blockquote\f[R]
@@ -2512,8 +2511,8 @@ does not produce a nested block quote in pandoc:
25122511.IP
25132512.nf
25142513\f[C]
2515−>\ This\ is\ a\ block\ quote.
2516−>>\ Nested.
2514+> This is a block quote.
2515+>> Nested.
25172516\f[R]
25182517.fi
25192518.SS Verbatim (code) blocks
@@ -2526,9 +2525,9 @@ For example,
25262525.IP
25272526.nf
25282527\f[C]
2529−\ \ \ \ if\ (a\ >\ 3)\ {
2530−\ \ \ \ \ \ moveShip(5\ *\ gravity,\ DOWN);
2531−\ \ \ \ }
2528+ if (a > 3) {
2529+ moveShip(5 * gravity, DOWN);
2530+ }
25322531\f[R]
25332532.fi
25342533.PP
@@ -2549,8 +2548,8 @@ No indentation is necessary:
25492548.nf
25502549\f[C]
25512550\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
2552−if\ (a\ >\ 3)\ {
2553−\ \ moveShip(5\ *\ gravity,\ DOWN);
2551+if (a > 3) {
2552+ moveShip(5 * gravity, DOWN);
25542553}
25552554\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
25562555\f[R]
@@ -2566,7 +2565,7 @@ longer row of tildes or backticks at the start and end:
25662565\f[C]
25672566\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
25682567\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
2569−code\ including\ tildes
2568+code including tildes
25702569\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
25712570\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
25722571\f[R]
@@ -2582,10 +2581,10 @@ using this syntax:
25822581.IP
25832582.nf
25842583\f[C]
2585−\[ti]\[ti]\[ti]\[ti]\ {#mycode\ .haskell\ .numberLines\ startFrom=\[dq]100\[dq]}
2586−qsort\ []\ \ \ \ \ =\ []
2587−qsort\ (x:xs)\ =\ qsort\ (filter\ (<\ x)\ xs)\ ++\ [x]\ ++
2588−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ qsort\ (filter\ (>=\ x)\ xs)
2584+\[ti]\[ti]\[ti]\[ti] {#mycode .haskell .numberLines startFrom=\[dq]100\[dq]}
2585+qsort [] = []
2586+qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
2587+ qsort (filter (>= x) xs)
25892588\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
25902589\f[R]
25912590.fi
@@ -2599,15 +2598,15 @@ LaTeX, Docx, Ms, and PowerPoint.
25992598If highlighting is supported for your output format and language, then
26002599the code block above will appear highlighted, with numbered lines.
26012600(To see which languages are supported, type
2602−\f[C]pandoc\ \-\-list\-highlight\-languages\f[R].) Otherwise, the code
2601+\f[C]pandoc \-\-list\-highlight\-languages\f[R].) Otherwise, the code
26032602block above will appear as follows:
26042603.IP
26052604.nf
26062605\f[C]
2607−<pre\ id=\[dq]mycode\[dq]\ class=\[dq]haskell\ numberLines\[dq]\ startFrom=\[dq]100\[dq]>
2608−\ \ <code>
2609−\ \ ...
2610−\ \ </code>
2606+<pre id=\[dq]mycode\[dq] class=\[dq]haskell numberLines\[dq] startFrom=\[dq]100\[dq]>
2607+ <code>
2608+ ...
2609+ </code>
26112610</pre>
26122611\f[R]
26132612.fi
@@ -2624,7 +2623,7 @@ block:
26242623.nf
26252624\f[C]
26262625\[ga]\[ga]\[ga]haskell
2627−qsort\ []\ =\ []
2626+qsort [] = []
26282627\[ga]\[ga]\[ga]
26292628\f[R]
26302629.fi
@@ -2633,8 +2632,8 @@ This is equivalent to:
26332632.IP
26342633.nf
26352634\f[C]
2636−\[ga]\[ga]\[ga]\ {.haskell}
2637−qsort\ []\ =\ []
2635+\[ga]\[ga]\[ga] {.haskell}
2636+qsort [] = []
26382637\[ga]\[ga]\[ga]
26392638\f[R]
26402639.fi
@@ -2657,14 +2656,14 @@ This is useful for verse and addresses:
26572656.IP
26582657.nf
26592658\f[C]
2660−|\ The\ limerick\ packs\ laughs\ anatomical
2661−|\ In\ space\ that\ is\ quite\ economical.
2662−|\ \ \ \ But\ the\ good\ ones\ I\[aq]ve\ seen
2663−|\ \ \ \ So\ seldom\ are\ clean
2664−|\ And\ the\ clean\ ones\ so\ seldom\ are\ comical
2659+| The limerick packs laughs anatomical
2660+| In space that is quite economical.
2661+| But the good ones I\[aq]ve seen
2662+| So seldom are clean
2663+| And the clean ones so seldom are comical
26652664
2666−|\ 200\ Main\ St.
2667−|\ Berkeley,\ CA\ 94718
2665+| 200 Main St.
2666+| Berkeley, CA 94718
26682667\f[R]
26692668.fi
26702669.PP
@@ -2673,10 +2672,10 @@ begin with a space.
26732672.IP
26742673.nf
26752674\f[C]
2676−|\ The\ Right\ Honorable\ Most\ Venerable\ and\ Righteous\ Samuel\ L.
2677−\ \ Constable,\ Jr.
2678−|\ 200\ Main\ St.
2679−|\ Berkeley,\ CA\ 94718
2675+| The Right Honorable Most Venerable and Righteous Samuel L.
2676+ Constable, Jr.
2677+| 200 Main St.
2678+| Berkeley, CA 94718
26802679\f[R]
26812680.fi
26822681.PP
@@ -2691,9 +2690,9 @@ Here is a simple example:
26912690.IP
26922691.nf
26932692\f[C]
2694−*\ one
2695−*\ two
2696−*\ three
2693+* one
2694+* two
2695+* three
26972696\f[R]
26982697.fi
26992698.PP
@@ -2703,11 +2702,11 @@ paragraph, put spaces between the items:
27032702.IP
27042703.nf
27052704\f[C]
2706−*\ one
2705+* one
27072706
2708−*\ two
2707+* two
27092708
2710−*\ three
2709+* three
27112710\f[R]
27122711.fi
27132712.PP
@@ -2720,9 +2719,9 @@ List items look best if subsequent lines are flush with the first line
27202719.IP
27212720.nf
27222721\f[C]
2723−*\ here\ is\ my\ first
2724−\ \ list\ item.
2725−*\ and\ my\ second.
2722+* here is my first
2723+ list item.
2724+* and my second.
27262725\f[R]
27272726.fi
27282727.PP
@@ -2730,9 +2729,9 @@ But Markdown also allows a \[dq]lazy\[dq] format:
27302729.IP
27312730.nf
27322731\f[C]
2733−*\ here\ is\ my\ first
2734−list\ item.
2735−*\ and\ my\ second.
2732+* here is my first
2733+list item.
2734+* and my second.
27362735\f[R]
27372736.fi
27382737.SS Block content in list items
@@ -2745,14 +2744,14 @@ marker.
27452744.IP
27462745.nf
27472746\f[C]
2748−\ \ *\ First\ paragraph.
2747+ * First paragraph.
27492748
2750−\ \ \ \ Continued.
2749+ Continued.
27512750
2752−\ \ *\ Second\ paragraph.\ With\ a\ code\ block,\ which\ must\ be\ indented
2753−\ \ \ \ eight\ spaces:
2751+ * Second paragraph. With a code block, which must be indented
2752+ eight spaces:
27542753
2755−\ \ \ \ \ \ \ \ {\ code\ }
2754+ { code }
27562755\f[R]
27572756.fi
27582757.PP
@@ -2763,9 +2762,9 @@ marker:
27632762.IP
27642763.nf
27652764\f[C]
2766−*\ \ \ \ \ code
2765+* code
27672766
2768−\ \ continuation\ paragraph
2767+ continuation paragraph
27692768\f[R]
27702769.fi
27712770.PP
@@ -2776,15 +2775,15 @@ character after the list marker of the containing list item.
27762775.IP
27772776.nf
27782777\f[C]
2779−*\ fruits
2780−\ \ +\ apples
2781−\ \ \ \ \-\ macintosh
2782−\ \ \ \ \-\ red\ delicious
2783−\ \ +\ pears
2784−\ \ +\ peaches
2785−*\ vegetables
2786−\ \ +\ broccoli
2787−\ \ +\ chard
2778+* fruits
2779+ + apples
2780+ \- macintosh
2781+ \- red delicious
2782+ + pears
2783+ + peaches
2784+* vegetables
2785+ + broccoli
2786+ + chard
27882787\f[R]
27892788.fi
27902789.PP
@@ -2795,14 +2794,14 @@ item, the first line of each must be indented.
27952794.IP
27962795.nf
27972796\f[C]
2798−+\ A\ lazy,\ lazy,\ list
2797++ A lazy, lazy, list
27992798item.
28002799
2801−+\ Another\ one;\ this\ looks
2802−bad\ but\ is\ legal.
2800++ Another one; this looks
2801+bad but is legal.
28032802
2804−\ \ \ \ Second\ paragraph\ of\ second
2805−list\ item.
2803+ Second paragraph of second
2804+list item.
28062805\f[R]
28072806.fi
28082807.SS Ordered lists
@@ -2817,9 +2816,9 @@ this list:
28172816.IP
28182817.nf
28192818\f[C]
2820−1.\ \ one
2821−2.\ \ two
2822−3.\ \ three
2819+1. one
2820+2. two
2821+3. three
28232822\f[R]
28242823.fi
28252824.PP
@@ -2827,9 +2826,9 @@ and this one:
28272826.IP
28282827.nf
28292828\f[C]
2830−5.\ \ one
2831−7.\ \ two
2832−1.\ \ three
2829+5. one
2830+7. two
2831+1. three
28332832\f[R]
28342833.fi
28352834.SS Extension: \f[C]fancy_lists\f[R]
@@ -2848,8 +2847,8 @@ be used as an ordered list marker in place of a numeral:
28482847.IP
28492848.nf
28502849\f[C]
2851−#.\ one
2852−#.\ two
2850+#. one
2851+#. two
28532852\f[R]
28542853.fi
28552854.SS Extension: \f[C]startnum\f[R]
@@ -2863,12 +2862,12 @@ numerals:
28632862.IP
28642863.nf
28652864\f[C]
2866−\ 9)\ \ Ninth
2867−10)\ \ Tenth
2868−11)\ \ Eleventh
2869−\ \ \ \ \ \ \ i.\ subone
2870−\ \ \ \ \ \ ii.\ subtwo
2871−\ \ \ \ \ iii.\ subthree
2865+ 9) Ninth
2866+10) Tenth
2867+11) Eleventh
2868+ i. subone
2869+ ii. subtwo
2870+ iii. subthree
28722871\f[R]
28732872.fi
28742873.PP
@@ -2878,10 +2877,10 @@ So, the following will create three lists:
28782877.IP
28792878.nf
28802879\f[C]
2881−(2)\ Two
2882−(5)\ Three
2883−1.\ \ Four
2884−*\ \ \ Five
2880+(2) Two
2881+(5) Three
2882+1. Four
2883+* Five
28852884\f[R]
28862885.fi
28872886.PP
@@ -2889,9 +2888,9 @@ If default list markers are desired, use \f[C]#.\f[R]:
28892888.IP
28902889.nf
28912890\f[C]
2892−#.\ \ one
2893−#.\ \ two
2894−#.\ \ three
2891+#. one
2892+#. two
2893+#. three
28952894\f[R]
28962895.fi
28972896.SS Definition lists
@@ -2902,17 +2901,17 @@ with some extensions.
29022901.IP
29032902.nf
29042903\f[C]
2905−Term\ 1
2904+Term 1
29062905
2907−:\ \ \ Definition\ 1
2906+: Definition 1
29082907
2909−Term\ 2\ with\ *inline\ markup*
2908+Term 2 with *inline markup*
29102909
2911−:\ \ \ Definition\ 2
2910+: Definition 2
29122911
2913−\ \ \ \ \ \ \ \ {\ some\ code,\ part\ of\ Definition\ 2\ }
2912+ { some code, part of Definition 2 }
29142913
2915−\ \ \ \ Third\ paragraph\ of\ definition\ 2.
2914+ Third paragraph of definition 2.
29162915\f[R]
29172916.fi
29182917.PP
@@ -2932,12 +2931,12 @@ element:
29322931.IP
29332932.nf
29342933\f[C]
2935−Term\ 1
2934+Term 1
29362935
2937−:\ \ \ Definition
2938−with\ lazy\ continuation.
2936+: Definition
2937+with lazy continuation.
29392938
2940−\ \ \ \ Second\ paragraph\ of\ the\ definition.
2939+ Second paragraph of the definition.
29412940\f[R]
29422941.fi
29432942.PP
@@ -2950,12 +2949,12 @@ definition:
29502949.IP
29512950.nf
29522951\f[C]
2953−Term\ 1
2954−\ \ \[ti]\ Definition\ 1
2952+Term 1
2953+ \[ti] Definition 1
29552954
2956−Term\ 2
2957−\ \ \[ti]\ Definition\ 2a
2958−\ \ \[ti]\ Definition\ 2b
2955+Term 2
2956+ \[ti] Definition 2a
2957+ \[ti] Definition 2b
29592958\f[R]
29602959.fi
29612960.PP
@@ -2976,12 +2975,12 @@ So, for example:
29762975.IP
29772976.nf
29782977\f[C]
2979−(\[at])\ \ My\ first\ example\ will\ be\ numbered\ (1).
2980−(\[at])\ \ My\ second\ example\ will\ be\ numbered\ (2).
2978+(\[at]) My first example will be numbered (1).
2979+(\[at]) My second example will be numbered (2).
29812980
2982−Explanation\ of\ examples.
2981+Explanation of examples.
29832982
2984−(\[at])\ \ My\ third\ example\ will\ be\ numbered\ (3).
2983+(\[at]) My third example will be numbered (3).
29852984\f[R]
29862985.fi
29872986.PP
@@ -2990,9 +2989,9 @@ document:
29902989.IP
29912990.nf
29922991\f[C]
2993−(\[at]good)\ \ This\ is\ a\ good\ example.
2992+(\[at]good) This is a good example.
29942993
2995−As\ (\[at]good)\ illustrates,\ ...
2994+As (\[at]good) illustrates, ...
29962995\f[R]
29972996.fi
29982997.PP
@@ -3013,13 +3012,13 @@ Consider this source:
30133012.IP
30143013.nf
30153014\f[C]
3016−+\ \ \ First
3017−+\ \ \ Second:
3018−\ \ \ \ \-\ \ \ Fee
3019−\ \ \ \ \-\ \ \ Fie
3020−\ \ \ \ \-\ \ \ Foe
3015++ First
3016++ Second:
3017+ \- Fee
3018+ \- Fie
3019+ \- Foe
30213020
3022−+\ \ \ Third
3021++ Third
30233022\f[R]
30243023.fi
30253024.PP
@@ -3044,16 +3043,16 @@ What if you want to put an indented code block after a list?
30443043.IP
30453044.nf
30463045\f[C]
3047−\-\ \ \ item\ one
3048−\-\ \ \ item\ two
3046+\- item one
3047+\- item two
30493048
3050−\ \ \ \ {\ my\ code\ block\ }
3049+ { my code block }
30513050\f[R]
30523051.fi
30533052.PP
30543053Trouble! Here pandoc (like other Markdown implementations) will treat
3055−\f[C]{\ my\ code\ block\ }\f[R] as the second paragraph of item two, and
3056−not as a code block.
3054+\f[C]{ my code block }\f[R] as the second paragraph of item two, and not
3055+as a code block.
30573056.PP
30583057To \[dq]cut off\[dq] the list after item two, you can insert some
30593058non\-indented content, like an HTML comment, which won\[aq]t produce
@@ -3061,12 +3060,12 @@ visible output in any format:
30613060.IP
30623061.nf
30633062\f[C]
3064−\-\ \ \ item\ one
3065−\-\ \ \ item\ two
3063+\- item one
3064+\- item two
30663065
3067−<!\-\-\ end\ of\ list\ \-\->
3066+<!\-\- end of list \-\->
30683067
3069−\ \ \ \ {\ my\ code\ block\ }
3068+ { my code block }
30703069\f[R]
30713070.fi
30723071.PP
@@ -3075,15 +3074,15 @@ one big list:
30753074.IP
30763075.nf
30773076\f[C]
3078−1.\ \ one
3079−2.\ \ two
3080−3.\ \ three
3077+1. one
3078+2. two
3079+3. three
30813080
3082−<!\-\-\ \-\->
3081+<!\-\- \-\->
30833082
3084−1.\ \ uno
3085−2.\ \ dos
3086−3.\ \ tres
3083+1. uno
3084+2. dos
3085+3. tres
30873086\f[R]
30883087.fi
30893088.SS Horizontal rules
@@ -3094,7 +3093,7 @@ horizontal rule:
30943093.IP
30953094.nf
30963095\f[C]
3097−*\ \ *\ \ *\ \ *
3096+* * * *
30983097
30993098\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
31003099\f[R]
@@ -3119,13 +3118,13 @@ Simple tables look like this:
31193118.IP
31203119.nf
31213120\f[C]
3122−\ \ Right\ \ \ \ \ Left\ \ \ \ \ Center\ \ \ \ \ Default
3123−\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
3124−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ 12
3125−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ 123
3126−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ 1
3121+ Right Left Center Default
3122+\-\-\-\-\-\-\- \-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-
3123+ 12 12 12 12
3124+ 123 123 123 123
3125+ 1 1 1 1
31273126
3128−Table:\ \ Demonstration\ of\ simple\ table\ syntax.
3127+Table: Demonstration of simple table syntax.
31293128\f[R]
31303129.fi
31313130.PP
@@ -3154,11 +3153,11 @@ For example:
31543153.IP
31553154.nf
31563155\f[C]
3157−\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
3158−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ \ 12
3159−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ \ 123
3160−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ \ 1
3161−\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
3156+\-\-\-\-\-\-\- \-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-
3157+ 12 12 12 12
3158+ 123 123 123 123
3159+ 1 1 1 1
3160+\-\-\-\-\-\-\- \-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-
31623161\f[R]
31633162.fi
31643163.PP
@@ -3176,19 +3175,19 @@ Here is an example:
31763175.nf
31773176\f[C]
31783177\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3179−\ Centered\ \ \ Default\ \ \ \ \ \ \ \ \ \ \ Right\ Left
3180−\ \ Header\ \ \ \ Aligned\ \ \ \ \ \ \ \ \ Aligned\ Aligned
3181−\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3182−\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that
3183−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
3178+ Centered Default Right Left
3179+ Header Aligned Aligned Aligned
3180+\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3181+ First row 12.0 Example of a row that
3182+ spans multiple lines.
31843183
3185−\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note
3186−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3187−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
3184+ Second row 5.0 Here\[aq]s another one. Note
3185+ the blank line between
3186+ rows.
31883187\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
31893188
3190−Table:\ Here\[aq]s\ the\ caption.\ It,\ too,\ may\ span
3191−multiple\ lines.
3189+Table: Here\[aq]s the caption. It, too, may span
3190+multiple lines.
31923191\f[R]
31933192.fi
31943193.PP
@@ -3211,16 +3210,16 @@ Headers may be omitted in multiline tables as well as simple tables:
32113210.IP
32123211.nf
32133212\f[C]
3214−\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3215−\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that
3216−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
3213+\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3214+ First row 12.0 Example of a row that
3215+ spans multiple lines.
32173216
3218−\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note
3219−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3220−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
3221−\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
3217+ Second row 5.0 Here\[aq]s another one. Note
3218+ the blank line between
3219+ rows.
3220+\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
32223221
3223−:\ Here\[aq]s\ a\ multiline\ table\ without\ headers.
3222+: Here\[aq]s a multiline table without headers.
32243223\f[R]
32253224.fi
32263225.PP
@@ -3233,16 +3232,16 @@ Grid tables look like this:
32333232.IP
32343233.nf
32353234\f[C]
3236−:\ Sample\ grid\ table.
3235+: Sample grid table.
32373236
32383237+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
3239−|\ Fruit\ \ \ \ \ \ \ \ \ |\ Price\ \ \ \ \ \ \ \ \ |\ Advantages\ \ \ \ \ \ \ \ \ |
3238+| Fruit | Price | Advantages |
32403239+===============+===============+====================+
3241−|\ Bananas\ \ \ \ \ \ \ |\ $1.34\ \ \ \ \ \ \ \ \ |\ \-\ built\-in\ wrapper\ |
3242−|\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ |\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ |\ \-\ bright\ color\ \ \ \ \ |
3240+| Bananas | $1.34 | \- built\-in wrapper |
3241+| | | \- bright color |
32433242+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
3244−|\ Oranges\ \ \ \ \ \ \ |\ $2.10\ \ \ \ \ \ \ \ \ |\ \-\ cures\ scurvy\ \ \ \ \ |
3245−|\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ |\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ |\ \-\ tasty\ \ \ \ \ \ \ \ \ \ \ \ |
3243+| Oranges | $2.10 | \- cures scurvy |
3244+| | | \- tasty |
32463245+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
32473246\f[R]
32483247.fi
@@ -3260,9 +3259,9 @@ the boundaries of the separator line after the header:
32603259.nf
32613260\f[C]
32623261+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
3263−|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
3262+| Right | Left | Centered |
32643263+==============:+:==============+:==================:+
3265−|\ Bananas\ \ \ \ \ \ \ |\ $1.34\ \ \ \ \ \ \ \ \ |\ built\-in\ wrapper\ \ \ |
3264+| Bananas | $1.34 | built\-in wrapper |
32663265+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
32673266\f[R]
32683267.fi
@@ -3272,7 +3271,7 @@ For headerless tables, the colons go on the top line instead:
32723271.nf
32733272\f[C]
32743273+\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+
3275−|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
3274+| Right | Left | Centered |
32763275+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
32773276\f[R]
32783277.fi
@@ -3291,13 +3290,13 @@ Pipe tables look like this:
32913290.IP
32923291.nf
32933292\f[C]
3294−|\ Right\ |\ Left\ |\ Default\ |\ Center\ |
3293+| Right | Left | Default | Center |
32953294|\-\-\-\-\-\-:|:\-\-\-\-\-|\-\-\-\-\-\-\-\-\-|:\-\-\-\-\-\-:|
3296−|\ \ \ 12\ \ |\ \ 12\ \ |\ \ \ \ 12\ \ \ |\ \ \ \ 12\ \ |
3297−|\ \ 123\ \ |\ \ 123\ |\ \ \ 123\ \ \ |\ \ \ 123\ \ |
3298−|\ \ \ \ 1\ \ |\ \ \ \ 1\ |\ \ \ \ \ 1\ \ \ |\ \ \ \ \ 1\ \ |
3295+| 12 | 12 | 12 | 12 |
3296+| 123 | 123 | 123 | 123 |
3297+| 1 | 1 | 1 | 1 |
32993298
3300−\ \ :\ Demonstration\ of\ pipe\ table\ syntax.
3299+ : Demonstration of pipe table syntax.
33013300\f[R]
33023301.fi
33033302.PP
@@ -3314,7 +3313,7 @@ So, this is a perfectly legal (though ugly) pipe table:
33143313.IP
33153314.nf
33163315\f[C]
3317−fruit|\ price
3316+fruit| price
33183317\-\-\-\-\-|\-\-\-\-\-:
33193318apple|2.05
33203319pear|1.37
@@ -3339,10 +3338,10 @@ be produced by Emacs\[aq] orgtbl\-mode:
33393338.IP
33403339.nf
33413340\f[C]
3342−|\ One\ |\ Two\ \ \ |
3341+| One | Two |
33433342|\-\-\-\-\-+\-\-\-\-\-\-\-|
3344−|\ my\ \ |\ table\ |
3345−|\ is\ \ |\ nice\ \ |
3343+| my | table |
3344+| is | nice |
33463345\f[R]
33473346.fi
33483347.PP
@@ -3357,9 +3356,9 @@ If the file begins with a title block
33573356.IP
33583357.nf
33593358\f[C]
3360−%\ title
3361−%\ author(s)\ (separated\ by\ semicolons)
3362−%\ date
3359+% title
3360+% author(s) (separated by semicolons)
3361+% date
33633362\f[R]
33643363.fi
33653364.PP
@@ -3373,11 +3372,11 @@ no author, you need a blank line:
33733372.nf
33743373\f[C]
33753374%
3376−%\ Author
3375+% Author
33773376
3378−%\ My\ title
3377+% My title
33793378%
3380−%\ June\ 15,\ 2006
3379+% June 15, 2006
33813380\f[R]
33823381.fi
33833382.PP
@@ -3386,8 +3385,8 @@ with leading space, thus:
33863385.IP
33873386.nf
33883387\f[C]
3389−%\ My\ title
3390−\ \ on\ multiple\ lines
3388+% My title
3389+ on multiple lines
33913390\f[R]
33923391.fi
33933392.PP
@@ -3397,13 +3396,13 @@ So, all of the following are equivalent:
33973396.IP
33983397.nf
33993398\f[C]
3400−%\ Author\ One
3401−\ \ Author\ Two
3399+% Author One
3400+ Author Two
34023401
3403−%\ Author\ One;\ Author\ Two
3402+% Author One; Author Two
34043403
3405−%\ Author\ One;
3406−\ \ Author\ Two
3404+% Author One;
3405+ Author Two
34073406\f[R]
34083407.fi
34093408.PP
@@ -3437,7 +3436,7 @@ Thus,
34373436.IP
34383437.nf
34393438\f[C]
3440−%\ PANDOC(1)
3439+% PANDOC(1)
34413440\f[R]
34423441.fi
34433442.PP
@@ -3445,7 +3444,7 @@ will yield a man page with the title \f[C]PANDOC\f[R] and section 1.
34453444.IP
34463445.nf
34473446\f[C]
3448−%\ PANDOC(1)\ Pandoc\ User\ Manuals
3447+% PANDOC(1) Pandoc User Manuals
34493448\f[R]
34503449.fi
34513450.PP
@@ -3453,7 +3452,7 @@ will also have \[dq]Pandoc User Manuals\[dq] in the footer.
34533452.IP
34543453.nf
34553454\f[C]
3456−%\ PANDOC(1)\ Pandoc\ User\ Manuals\ |\ Version\ 4.0
3455+% PANDOC(1) Pandoc User Manuals | Version 4.0
34573456\f[R]
34583457.fi
34593458.PP
@@ -3462,7 +3461,7 @@ will also have \[dq]Version 4.0\[dq] in the header.
34623461.PP
34633462A YAML metadata block is a valid YAML object, delimited by a line of
34643463three hyphens (\f[C]\-\-\-\f[R]) at the top and a line of three hyphens
3465−(\f[C]\-\-\-\f[R]) or three dots (\f[C]\&...\f[R]) at the bottom.
3464+(\f[C]\-\-\-\f[R]) or three dots (\f[C]...\f[R]) at the bottom.
34663465A YAML metadata block may occur anywhere in the document, but if it is
34673466not at the beginning, it must be preceded by a blank line.
34683467(Note that, because of the way pandoc concatenates input files when
@@ -3472,13 +3471,13 @@ files:
34723471.IP
34733472.nf
34743473\f[C]
3475−pandoc\ chap1.md\ chap2.md\ chap3.md\ metadata.yaml\ \-s\ \-o\ book.html
3474+pandoc chap1.md chap2.md chap3.md metadata.yaml \-s \-o book.html
34763475\f[R]
34773476.fi
34783477.PP
34793478Just be sure that the YAML file begins with \f[C]\-\-\-\f[R] and ends
3480−with \f[C]\-\-\-\f[R] or \f[C]\&...\f[R].) Alternatively, you can use
3481−the \f[C]\-\-metadata\-file\f[R] option.
3479+with \f[C]\-\-\-\f[R] or \f[C]...\f[R].) Alternatively, you can use the
3480+\f[C]\-\-metadata\-file\f[R] option.
34823481Using that approach however, you cannot reference content (like
34833482footnotes) from the main markdown input document.
34843483.PP
@@ -3497,7 +3496,7 @@ The metadata fields will be combined through a \f[I]left\-biased
34973496union\f[R]: if two metadata blocks attempt to set the same field, the
34983497value from the first block will be taken.
34993498.PP
3500−When pandoc is used with \f[C]\-t\ markdown\f[R] to create a Markdown
3499+When pandoc is used with \f[C]\-t markdown\f[R] to create a Markdown
35013500document, a YAML metadata block will be produced only if the
35023501\f[C]\-s/\-\-standalone\f[R] option is used.
35033502All of the metadata will appear in a single block at the beginning of
@@ -3513,15 +3512,15 @@ block\-level formatting:
35133512.nf
35143513\f[C]
35153514\-\-\-
3516−title:\ \ \[aq]This\ is\ the\ title:\ it\ contains\ a\ colon\[aq]
3515+title: \[aq]This is the title: it contains a colon\[aq]
35173516author:
3518−\-\ Author\ One
3519−\-\ Author\ Two
3520−keywords:\ [nothing,\ nothingness]
3521−abstract:\ |
3522−\ \ This\ is\ the\ abstract.
3517+\- Author One
3518+\- Author Two
3519+keywords: [nothing, nothingness]
3520+abstract: |
3521+ This is the abstract.
35233522
3524−\ \ It\ consists\ of\ two\ paragraphs.
3523+ It consists of two paragraphs.
35253524\&...
35263525\f[R]
35273526.fi
@@ -3533,8 +3532,8 @@ field:
35333532.IP
35343533.nf
35353534\f[C]
3536−<p>This\ is\ the\ abstract.</p>
3537−<p>It\ consists\ of\ two\ paragraphs.</p>
3535+<p>This is the abstract.</p>
3536+<p>It consists of two paragraphs.</p>
35383537\f[R]
35393538.fi
35403539.PP
@@ -3549,12 +3548,12 @@ author if one is given:
35493548.nf
35503549\f[C]
35513550\-\-\-
3552−title:\ The\ document\ title
3551+title: The document title
35533552author:
3554−\-\ name:\ Author\ One
3555−\ \ affiliation:\ University\ of\ Somewhere
3556−\-\ name:\ Author\ Two
3557−\ \ affiliation:\ University\ of\ Nowhere
3553+\- name: Author One
3554+ affiliation: University of Somewhere
3555+\- name: Author Two
3556+ affiliation: University of Nowhere
35583557\&...
35593558\f[R]
35603559.fi
@@ -3566,7 +3565,7 @@ custom template:
35663565\f[C]
35673566$for(author)$
35683567$if(author.name)$
3569−$author.name$$if(author.affiliation)$\ ($author.affiliation$)$endif$
3568+$author.name$$if(author.affiliation)$ ($author.affiliation$)$endif$
35703569$else$
35713570$author$
35723571$endif$
@@ -3584,11 +3583,11 @@ For example:
35843583.nf
35853584\f[C]
35863585header\-includes:
3587−\-\ |
3588−\ \ \[ga]\[ga]\[ga]{=latex}
3589−\ \ \[rs]let\[rs]oldsection\[rs]section
3590−\ \ \[rs]renewcommand{\[rs]section}[1]{\[rs]clearpage\[rs]oldsection{#1}}
3591−\ \ \[ga]\[ga]\[ga]
3586+\- |
3587+ \[ga]\[ga]\[ga]{=latex}
3588+ \[rs]let\[rs]oldsection\[rs]section
3589+ \[rs]renewcommand{\[rs]section}[1]{\[rs]clearpage\[rs]oldsection{#1}}
3590+ \[ga]\[ga]\[ga]
35923591\f[R]
35933592.fi
35943593.SS Backslash escapes
@@ -3641,7 +3640,7 @@ A backslash\-escaped newline (i.e.
36413640a backslash occurring at the end of a line) is parsed as a hard line
36423641break.
36433642It will appear in TeX output as \f[C]\[rs]\[rs]\f[R] and in HTML as
3644−\f[C]<br\ />\f[R].
3643+\f[C]<br />\f[R].
36453644This is a nice alternative to Markdown\[aq]s \[dq]invisible\[dq] way of
36463645indicating hard line breaks using two trailing spaces on a line.
36473646.PP
@@ -3654,8 +3653,8 @@ To \f[I]emphasize\f[R] some text, surround it with \f[C]*\f[R]s or
36543653.IP
36553654.nf
36563655\f[C]
3657−This\ text\ is\ _emphasized\ with\ underscores_,\ and\ this
3658−is\ *emphasized\ with\ asterisks*.
3656+This text is _emphasized with underscores_, and this
3657+is *emphasized with asterisks*.
36593658\f[R]
36603659.fi
36613660.PP
@@ -3663,7 +3662,7 @@ Double \f[C]*\f[R] or \f[C]_\f[R] produces \f[B]strong emphasis\f[R]:
36633662.IP
36643663.nf
36653664\f[C]
3666−This\ is\ **strong\ emphasis**\ and\ __with\ underscores__.
3665+This is **strong emphasis** and __with underscores__.
36673666\f[R]
36683667.fi
36693668.PP
@@ -3672,7 +3671,7 @@ backslash\-escaped, will not trigger emphasis:
36723671.IP
36733672.nf
36743673\f[C]
3675−This\ is\ *\ not\ emphasized\ *,\ and\ \[rs]*neither\ is\ this\[rs]*.
3674+This is * not emphasized *, and \[rs]*neither is this\[rs]*.
36763675\f[R]
36773676.fi
36783677.SS Extension: \f[C]intraword_underscores\f[R]
@@ -3684,7 +3683,7 @@ If you want to emphasize just part of a word, use \f[C]*\f[R]:
36843683.IP
36853684.nf
36863685\f[C]
3687−feas*ible*,\ not\ feas*able*.
3686+feas*ible*, not feas*able*.
36883687\f[R]
36893688.fi
36903689.SS Strikeout
@@ -3696,7 +3695,7 @@ Thus, for example,
36963695.IP
36973696.nf
36983697\f[C]
3699−This\ \[ti]\[ti]is\ deleted\ text.\[ti]\[ti]
3698+This \[ti]\[ti]is deleted text.\[ti]\[ti]
37003699\f[R]
37013700.fi
37023701.SS Superscripts and subscripts
@@ -3709,7 +3708,7 @@ Thus, for example,
37093708.IP
37103709.nf
37113710\f[C]
3712−H\[ti]2\[ti]O\ is\ a\ liquid.\ \ 2\[ha]10\[ha]\ is\ 1024.
3711+H\[ti]2\[ti]O is a liquid. 2\[ha]10\[ha] is 1024.
37133712\f[R]
37143713.fi
37153714.PP
@@ -3718,14 +3717,14 @@ must be escaped with backslashes.
37183717(This is to prevent accidental superscripting and subscripting through
37193718the ordinary use of \f[C]\[ti]\f[R] and \f[C]\[ha]\f[R].) Thus, if you
37203719want the letter P with \[aq]a cat\[aq] in subscripts, use
3721−\f[C]P\[ti]a\[rs]\ cat\[ti]\f[R], not \f[C]P\[ti]a\ cat\[ti]\f[R].
3720+\f[C]P\[ti]a\[rs] cat\[ti]\f[R], not \f[C]P\[ti]a cat\[ti]\f[R].
37223721.SS Verbatim
37233722.PP
37243723To make a short span of text verbatim, put it inside backticks:
37253724.IP
37263725.nf
37273726\f[C]
3728−What\ is\ the\ difference\ between\ \[ga]>>=\[ga]\ and\ \[ga]>>\[ga]?
3727+What is the difference between \[ga]>>=\[ga] and \[ga]>>\[ga]?
37293728\f[R]
37303729.fi
37313730.PP
@@ -3733,7 +3732,7 @@ If the verbatim text includes a backtick, use double backticks:
37333732.IP
37343733.nf
37353734\f[C]
3736−Here\ is\ a\ literal\ backtick\ \[ga]\[ga]\ \[ga]\ \[ga]\[ga].
3735+Here is a literal backtick \[ga]\[ga] \[ga] \[ga]\[ga].
37373736\f[R]
37383737.fi
37393738.PP
@@ -3749,7 +3748,7 @@ in verbatim contexts:
37493748.IP
37503749.nf
37513750\f[C]
3752−This\ is\ a\ backslash\ followed\ by\ an\ asterisk:\ \[ga]\[rs]*\[ga].
3751+This is a backslash followed by an asterisk: \[ga]\[rs]*\[ga].
37533752\f[R]
37543753.fi
37553754.SS Extension: \f[C]inline_code_attributes\f[R]
@@ -3768,7 +3767,7 @@ To write small caps, use the \f[C]smallcaps\f[R] class:
37683767.IP
37693768.nf
37703769\f[C]
3771−[Small\ caps]{.smallcaps}
3770+[Small caps]{.smallcaps}
37723771\f[R]
37733772.fi
37743773.PP
@@ -3776,7 +3775,7 @@ Or, without the \f[C]bracketed_spans\f[R] extension:
37763775.IP
37773776.nf
37783777\f[C]
3779−<span\ class=\[dq]smallcaps\[dq]>Small\ caps</span>
3778+<span class=\[dq]smallcaps\[dq]>Small caps</span>
37803779\f[R]
37813780.fi
37823781.PP
@@ -3784,7 +3783,7 @@ For compatibility with other Markdown flavors, CSS is also supported:
37843783.IP
37853784.nf
37863785\f[C]
3787−<span\ style=\[dq]font\-variant:small\-caps;\[dq]>Small\ caps</span>
3786+<span style=\[dq]font\-variant:small\-caps;\[dq]>Small caps</span>
37883787\f[R]
37893788.fi
37903789.PP
@@ -3797,7 +3796,7 @@ The opening \f[C]$\f[R] must have a non\-space character immediately to
37973796its right, while the closing \f[C]$\f[R] must have a non\-space
37983797character immediately to its left, and must not be followed immediately
37993798by a digit.
3800−Thus, \f[C]$20,000\ and\ $30,000\f[R] won\[aq]t parse as math.
3799+Thus, \f[C]$20,000 and $30,000\f[R] won\[aq]t parse as math.
38013800If for some reason you need to enclose text in literal \f[C]$\f[R]
38023801characters, backslash\-escape them and they won\[aq]t be treated as math
38033802delimiters.
@@ -3822,14 +3821,14 @@ It will be rendered as \f[C]latexmath:[...]\f[R].
38223821.B Texinfo
38233822It will be rendered inside a \f[C]\[at]math\f[R] command.
38243823.TP
3825−.B groff man
3824+.B roff man
38263825It will be rendered verbatim without \f[C]$\f[R]\[aq]s.
38273826.TP
38283827.B MediaWiki, DokuWiki
38293828It will be rendered inside \f[C]<math>\f[R] tags.
38303829.TP
38313830.B Textile
3832−It will be rendered inside \f[C]<span\ class=\[dq]math\[dq]>\f[R] tags.
3831+It will be rendered inside \f[C]<span class=\[dq]math\[dq]>\f[R] tags.
38333832.TP
38343833.B RTF, OpenDocument
38353834It will be rendered, if possible, using Unicode characters, and will
@@ -3894,7 +3893,7 @@ Thus, for example, pandoc will turn
38943893<table>
38953894<tr>
38963895<td>*one*</td>
3897−<td>[a\ link](http://google.com)</td>
3896+<td>[a link](http://google.com)</td>
38983897</tr>
38993898</table>
39003899\f[R]
@@ -3907,7 +3906,7 @@ into
39073906<table>
39083907<tr>
39093908<td><em>one</em></td>
3910−<td><a\ href=\[dq]http://google.com\[dq]>a\ link</a></td>
3909+<td><a href=\[dq]http://google.com\[dq]>a link</a></td>
39113910</tr>
39123911</table>
39133912\f[R]
@@ -3947,7 +3946,7 @@ Thus, for example, you can use LaTeX to include BibTeX citations:
39473946.IP
39483947.nf
39493948\f[C]
3950−This\ result\ was\ proved\ in\ \[rs]cite{jones.1967}.
3949+This result was proved in \[rs]cite{jones.1967}.
39513950\f[R]
39523951.fi
39533952.PP
@@ -3956,10 +3955,10 @@ Note that in LaTeX environments, like
39563955.nf
39573956\f[C]
39583957\[rs]begin{tabular}{|l|l|}\[rs]hline
3959−Age\ &\ Frequency\ \[rs]\[rs]\ \[rs]hline
3960−18\-\-25\ \ &\ 15\ \[rs]\[rs]
3961−26\-\-35\ \ &\ 33\ \[rs]\[rs]
3962−36\-\-45\ \ &\ 22\ \[rs]\[rs]\ \[rs]hline
3958+Age & Frequency \[rs]\[rs] \[rs]hline
3959+18\-\-25 & 15 \[rs]\[rs]
3960+26\-\-35 & 33 \[rs]\[rs]
3961+36\-\-45 & 22 \[rs]\[rs] \[rs]hline
39633962\[rs]end{tabular}
39643963\f[R]
39653964.fi
@@ -3974,13 +3973,13 @@ Emacs Org mode, and ConTeXt.
39743973.PP
39753974Inline spans and fenced code blocks with a special kind of attribute
39763975will be parsed as raw content with the designated format.
3977−For example, the following produces a raw groff \f[C]ms\f[R] block:
3976+For example, the following produces a raw roff \f[C]ms\f[R] block:
39783977.IP
39793978.nf
39803979\f[C]
39813980\[ga]\[ga]\[ga]{=ms}
39823981\&.MYMACRO
3983−blah\ blah
3982+blah blah
39843983\[ga]\[ga]\[ga]
39853984\f[R]
39863985.fi
@@ -3989,7 +3988,7 @@ And the following produces a raw \f[C]html\f[R] inline element:
39893988.IP
39903989.nf
39913990\f[C]
3992−This\ is\ \[ga]<a>html</a>\[ga]{=html}
3991+This is \[ga]<a>html</a>\[ga]{=html}
39933992\f[R]
39943993.fi
39953994.PP
@@ -4000,9 +3999,9 @@ a pagebreak:
40003999\f[C]
40014000\[ga]\[ga]\[ga]{=openxml}
40024001<w:p>
4003−\ \ <w:r>
4004−\ \ \ \ <w:br\ w:type=\[dq]page\[dq]/>
4005−\ \ </w:r>
4002+ <w:r>
4003+ <w:br w:type=\[dq]page\[dq]/>
4004+ </w:r>
40064005</w:p>
40074006\[ga]\[ga]\[ga]
40084007\f[R]
@@ -4010,7 +4009,7 @@ a pagebreak:
40104009.PP
40114010The format name should match the target format name (see
40124011\f[C]\-t/\-\-to\f[R], above, for a list, or use
4013−\f[C]pandoc\ \-\-list\-output\-formats\f[R]).
4012+\f[C]pandoc \-\-list\-output\-formats\f[R]).
40144013Use \f[C]openxml\f[R] for \f[C]docx\f[R] output, \f[C]opendocument\f[R]
40154014for \f[C]odt\f[R] output, \f[C]html5\f[R] for \f[C]epub3\f[R] output,
40164015\f[C]html4\f[R] for \f[C]epub2\f[R] output, and \f[C]latex\f[R],
@@ -4034,9 +4033,9 @@ LaTeX:
40344033.IP
40354034.nf
40364035\f[C]
4037−\[rs]newcommand{\[rs]tuple}[1]{\[rs]langle\ #1\ \[rs]rangle}
4036+\[rs]newcommand{\[rs]tuple}[1]{\[rs]langle #1 \[rs]rangle}
40384037
4039−$\[rs]tuple{a,\ b,\ c}$
4038+$\[rs]tuple{a, b, c}$
40404039\f[R]
40414040.fi
40424041.PP
@@ -4071,8 +4070,8 @@ the URL in parentheses.
40714070.IP
40724071.nf
40734072\f[C]
4074−This\ is\ an\ [inline\ link](/url),\ and\ here\[aq]s\ [one\ with
4075−a\ title](http://fsf.org\ \[dq]click\ here\ for\ a\ good\ time!\[dq]).
4073+This is an [inline link](/url), and here\[aq]s [one with
4074+a title](http://fsf.org \[dq]click here for a good time!\[dq]).
40764075\f[R]
40774076.fi
40784077.PP
@@ -4086,7 +4085,7 @@ prefixed with \f[C]mailto\f[R]:
40864085.IP
40874086.nf
40884087\f[C]
4089−[Write\ me!](mailto:sam\[at]green.eggs.ham)
4088+[Write me!](mailto:sam\[at]green.eggs.ham)
40904089\f[R]
40914090.fi
40924091.SS Reference links
@@ -4110,10 +4109,10 @@ Here are some examples:
41104109.IP
41114110.nf
41124111\f[C]
4113−[my\ label\ 1]:\ /foo/bar.html\ \ \[dq]My\ title,\ optional\[dq]
4114−[my\ label\ 2]:\ /foo
4115−[my\ label\ 3]:\ http://fsf.org\ (The\ free\ software\ foundation)
4116−[my\ label\ 4]:\ /bar#special\ \ \[aq]A\ title\ in\ single\ quotes\[aq]
4112+[my label 1]: /foo/bar.html \[dq]My title, optional\[dq]
4113+[my label 2]: /foo
4114+[my label 3]: http://fsf.org (The free software foundation)
4115+[my label 4]: /bar#special \[aq]A title in single quotes\[aq]
41174116\f[R]
41184117.fi
41194118.PP
@@ -4121,7 +4120,7 @@ The URL may optionally be surrounded by angle brackets:
41214120.IP
41224121.nf
41234122\f[C]
4124−[my\ label\ 5]:\ <http://foo.bar.baz>
4123+[my label 5]: <http://foo.bar.baz>
41254124\f[R]
41264125.fi
41274126.PP
@@ -4129,8 +4128,8 @@ The title may go on the next line:
41294128.IP
41304129.nf
41314130\f[C]
4132−[my\ label\ 3]:\ http://fsf.org
4133−\ \ \[dq]The\ free\ software\ foundation\[dq]
4131+[my label 3]: http://fsf.org
4132+ \[dq]The free software foundation\[dq]
41344133\f[R]
41354134.fi
41364135.PP
@@ -4139,9 +4138,9 @@ So, this will work:
41394138.IP
41404139.nf
41414140\f[C]
4142−Here\ is\ [my\ link][FOO]
4141+Here is [my link][FOO]
41434142
4144−[Foo]:\ /bar/baz
4143+[Foo]: /bar/baz
41454144\f[R]
41464145.fi
41474146.PP
@@ -4150,9 +4149,9 @@ empty:
41504149.IP
41514150.nf
41524151\f[C]
4153−See\ [my\ website][].
4152+See [my website][].
41544153
4155−[my\ website]:\ http://foo.bar.baz
4154+[my website]: http://foo.bar.baz
41564155\f[R]
41574156.fi
41584157.PP
@@ -4165,9 +4164,9 @@ implementations:
41654164.IP
41664165.nf
41674166\f[C]
4168−>\ My\ block\ [quote].
4167+> My block [quote].
41694168>
4170−>\ [quote]:\ /foo
4169+> [quote]: /foo
41714170\f[R]
41724171.fi
41734172.SS Extension: \f[C]shortcut_reference_links\f[R]
@@ -4177,9 +4176,9 @@ be omitted entirely:
41774176.IP
41784177.nf
41794178\f[C]
4180−See\ [my\ website].
4179+See [my website].
41814180
4182−[my\ website]:\ http://foo.bar.baz
4181+[my website]: http://foo.bar.baz
41834182\f[R]
41844183.fi
41854184.SS Internal links
@@ -4190,7 +4189,7 @@ For example:
41904189.IP
41914190.nf
41924191\f[C]
4193−See\ the\ [Introduction](#introduction).
4192+See the [Introduction](#introduction).
41944193\f[R]
41954194.fi
41964195.PP
@@ -4198,9 +4197,9 @@ or
41984197.IP
41994198.nf
42004199\f[C]
4201−See\ the\ [Introduction].
4200+See the [Introduction].
42024201
4203−[Introduction]:\ #introduction
4202+[Introduction]: #introduction
42044203\f[R]
42054204.fi
42064205.PP
@@ -4214,11 +4213,11 @@ The link text will be used as the image\[aq]s alt text:
42144213.IP
42154214.nf
42164215\f[C]
4217−
4216+
42184217
4219−![movie\ reel]
4218+![movie reel]
42204219
4221−[movie\ reel]:\ movie.gif
4220+[movie reel]: movie.gif
42224221\f[R]
42234222.fi
42244223.SS Extension: \f[C]implicit_figures\f[R]
@@ -4229,7 +4228,7 @@ The image\[aq]s alt text will be used as the caption.
42294228.IP
42304229.nf
42314230\f[C]
4232−
4231+
42334232\f[R]
42344233.fi
42354234.PP
@@ -4245,7 +4244,7 @@ One way to do this is to insert a nonbreaking space after the image:
42454244.IP
42464245.nf
42474246\f[C]
4248−![This\ image\ won\[aq]t\ be\ a\ figure](/url/of/image.png)\[rs]
4247+![This image won\[aq]t be a figure](/url/of/image.png)\[rs]
42494248\f[R]
42504249.fi
42514250.PP
@@ -4258,15 +4257,15 @@ Attributes can be set on links and images:
42584257.IP
42594258.nf
42604259\f[C]
4261−An\ inline\ {#id\ .class\ width=30\ height=20px}
4262−and\ a\ reference\ ![image][ref]\ with\ attributes.
4260+An inline {#id .class width=30 height=20px}
4261+and a reference ![image][ref] with attributes.
42634262
4264−[ref]:\ foo.jpg\ \[dq]optional\ title\[dq]\ {#id\ .class\ key=val\ key2=\[dq]val\ 2\[dq]}
4263+[ref]: foo.jpg \[dq]optional title\[dq] {#id .class key=val key2=\[dq]val 2\[dq]}
42654264\f[R]
42664265.fi
42674266.PP
42684267(This syntax is compatible with PHP Markdown Extra when only
4269−\f[C]#id\f[R] and \f[C]\&.class\f[R] are used.)
4268+\f[C]#id\f[R] and \f[C].class\f[R] are used.)
42704269.PP
42714270For HTML and EPUB, all attributes except \f[C]width\f[R] and
42724271\f[C]height\f[R] (but including \f[C]srcset\f[R] and \f[C]sizes\f[R])
@@ -4285,7 +4284,7 @@ For example:
42854284.IP
42864285.nf
42874286\f[C]
4288−{\ width=50%\ }
4287+{ width=50% }
42894288\f[R]
42904289.fi
42914290.IP \[bu] 2
@@ -4297,13 +4296,20 @@ inch.
42974296The default is 96dpi.
42984297.IP \[bu] 2
42994298The \f[C]%\f[R] unit is generally relative to some available space.
4300−For example the above example will render to
4301−\f[C]<img\ href=\[dq]file.jpg\[dq]\ style=\[dq]width:\ 50%;\[dq]\ />\f[R]
4302−(HTML),
4303−\f[C]\[rs]includegraphics[width=0.5\[rs]textwidth]{file.jpg}\f[R]
4304−(LaTeX), or
4299+For example the above example will render to the following.
4300+.RS 2
4301+.IP \[bu] 2
4302+HTML:
4303+\f[C]<img href=\[dq]file.jpg\[dq] style=\[dq]width: 50%;\[dq] />\f[R]
4304+.IP \[bu] 2
4305+LaTeX:
4306+\f[C]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
4307+(If you\[aq]re using a custom template, you need to configure
4308+\f[C]graphicx\f[R] as in the default template.)
4309+.IP \[bu] 2
4310+ConTeXt:
43054311\f[C]\[rs]externalfigure[file.jpg][width=0.5\[rs]textwidth]\f[R]
4306−(ConTeXt).
4312+.RE
43074313.IP \[bu] 2
43084314Some output formats have a notion of a class (ConTeXt) or a unique
43094315identifier (LaTeX \f[C]\[rs]caption\f[R]), or both (HTML).
@@ -4338,10 +4344,10 @@ Example:
43384344.IP
43394345.nf
43404346\f[C]
4341−:::::\ {#special\ .sidebar}
4342−Here\ is\ a\ paragraph.
4347+::::: {#special .sidebar}
4348+Here is a paragraph.
43434349
4344−And\ another.
4350+And another.
43454351:::::
43464352\f[R]
43474353.fi
@@ -4352,11 +4358,11 @@ attributes:
43524358.IP
43534359.nf
43544360\f[C]
4355−:::\ Warning\ ::::::
4356−This\ is\ a\ warning.
4361+::: Warning ::::::
4362+This is a warning.
43574363
4358−:::\ Danger
4359−This\ is\ a\ warning\ within\ a\ warning.
4364+::: Danger
4365+This is a warning within a warning.
43604366:::
43614367::::::::::::::::::
43624368\f[R]
@@ -4375,7 +4381,7 @@ immediately by attributes:
43754381.IP
43764382.nf
43774383\f[C]
4378−[This\ is\ *some\ text*]{.class\ key=\[dq]val\[dq]}
4384+[This is *some text*]{.class key=\[dq]val\[dq]}
43794385\f[R]
43804386.fi
43814387.SS Footnotes
@@ -4385,23 +4391,23 @@ Pandoc\[aq]s Markdown allows footnotes, using the following syntax:
43854391.IP
43864392.nf
43874393\f[C]
4388−Here\ is\ a\ footnote\ reference,[\[ha]1]\ and\ another.[\[ha]longnote]
4394+Here is a footnote reference,[\[ha]1] and another.[\[ha]longnote]
43894395
4390−[\[ha]1]:\ Here\ is\ the\ footnote.
4396+[\[ha]1]: Here is the footnote.
43914397
4392−[\[ha]longnote]:\ Here\[aq]s\ one\ with\ multiple\ blocks.
4398+[\[ha]longnote]: Here\[aq]s one with multiple blocks.
43934399
4394−\ \ \ \ Subsequent\ paragraphs\ are\ indented\ to\ show\ that\ they
4395−belong\ to\ the\ previous\ footnote.
4400+ Subsequent paragraphs are indented to show that they
4401+belong to the previous footnote.
43964402
4397−\ \ \ \ \ \ \ \ {\ some.code\ }
4403+ { some.code }
43984404
4399−\ \ \ \ The\ whole\ paragraph\ can\ be\ indented,\ or\ just\ the\ first
4400−\ \ \ \ line.\ \ In\ this\ way,\ multi\-paragraph\ footnotes\ work\ like
4401−\ \ \ \ multi\-paragraph\ list\ items.
4405+ The whole paragraph can be indented, or just the first
4406+ line. In this way, multi\-paragraph footnotes work like
4407+ multi\-paragraph list items.
44024408
4403−This\ paragraph\ won\[aq]t\ be\ part\ of\ the\ note,\ because\ it
4404−isn\[aq]t\ indented.
4409+This paragraph won\[aq]t be part of the note, because it
4410+isn\[aq]t indented.
44054411\f[R]
44064412.fi
44074413.PP
@@ -4423,8 +4429,8 @@ The syntax is as follows:
44234429.IP
44244430.nf
44254431\f[C]
4426−Here\ is\ an\ inline\ note.\[ha][Inlines\ notes\ are\ easier\ to\ write,\ since
4427−you\ don\[aq]t\ have\ to\ pick\ an\ identifier\ and\ move\ down\ to\ type\ the
4432+Here is an inline note.\[ha][Inlines notes are easier to write, since
4433+you don\[aq]t have to pick an identifier and move down to type the
44284434note.]
44294435\f[R]
44304436.fi
@@ -4440,7 +4446,7 @@ Basic usage is
44404446.IP
44414447.nf
44424448\f[C]
4443−pandoc\ \-\-filter\ pandoc\-citeproc\ myinput.txt
4449+pandoc \-\-filter pandoc\-citeproc myinput.txt
44444450\f[R]
44454451.fi
44464452.PP
@@ -4518,12 +4524,12 @@ T}@T{
45184524T}
45194525.TE
45204526.PP
4521−Note that \f[C]\&.bib\f[R] can be used with both BibTeX and BibLaTeX
4522−files; use \f[C]\&.bibtex\f[R] to force BibTeX.
4527+Note that \f[C].bib\f[R] can be used with both BibTeX and BibLaTeX
4528+files; use \f[C].bibtex\f[R] to force BibTeX.
45234529.PP
4524−Note that \f[C]pandoc\-citeproc\ \-\-bib2json\f[R] and
4525−\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[R] can produce \f[C]\&.json\f[R]
4526−and \f[C]\&.yaml\f[R] files from any of the supported formats.
4530+Note that \f[C]pandoc\-citeproc \-\-bib2json\f[R] and
4531+\f[C]pandoc\-citeproc \-\-bib2yaml\f[R] can produce \f[C].json\f[R] and
4532+\f[C].yaml\f[R] files from any of the supported formats.
45274533.PP
45284534In\-field markup: In BibTeX and BibLaTeX databases, pandoc\-citeproc
45294535parses a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown;
@@ -4535,7 +4541,7 @@ italics
45354541.B \f[C]<b>...</b>\f[R]
45364542bold
45374543.TP
4538−.B \f[C]<span\ style=\[dq]font\-variant:small\-caps;\[dq]>...</span>\f[R] or \f[C]<sc>...</sc>\f[R]
4544+.B \f[C]<span style=\[dq]font\-variant:small\-caps;\[dq]>...</span>\f[R] or \f[C]<sc>...</sc>\f[R]
45394545small capitals
45404546.TP
45414547.B \f[C]<sub>...</sub>\f[R]
@@ -4544,10 +4550,10 @@ subscript
45444550.B \f[C]<sup>...</sup>\f[R]
45454551superscript
45464552.TP
4547−.B \f[C]<span\ class=\[dq]nocase\[dq]>...</span>\f[R]
4553+.B \f[C]<span class=\[dq]nocase\[dq]>...</span>\f[R]
45484554prevent a phrase from being capitalized as title case
45494555.PP
4550−\f[C]pandoc\-citeproc\ \-j\f[R] and \f[C]\-y\f[R] interconvert the CSL
4556+\f[C]pandoc\-citeproc \-j\f[R] and \f[C]\-y\f[R] interconvert the CSL
45514557JSON and CSL YAML formats as far as possible.
45524558.PP
45534559As an alternative to specifying a bibliography file using
@@ -4561,33 +4567,33 @@ example:
45614567\f[C]
45624568\-\-\-
45634569references:
4564−\-\ type:\ article\-journal
4565−\ \ id:\ WatsonCrick1953
4566−\ \ author:
4567−\ \ \-\ family:\ Watson
4568−\ \ \ \ given:\ J.\ D.
4569−\ \ \-\ family:\ Crick
4570−\ \ \ \ given:\ F.\ H.\ C.
4571−\ \ issued:
4572−\ \ \ \ date\-parts:
4573−\ \ \ \ \-\ \-\ 1953
4574−\ \ \ \ \ \ \-\ 4
4575−\ \ \ \ \ \ \-\ 25
4576−\ \ title:\ \[aq]Molecular\ structure\ of\ nucleic\ acids:\ a\ structure\ for\ deoxyribose
4577−\ \ \ \ nucleic\ acid\[aq]
4578−\ \ title\-short:\ Molecular\ structure\ of\ nucleic\ acids
4579−\ \ container\-title:\ Nature
4580−\ \ volume:\ 171
4581−\ \ issue:\ 4356
4582−\ \ page:\ 737\-738
4583−\ \ DOI:\ 10.1038/171737a0
4584−\ \ URL:\ http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
4585−\ \ language:\ en\-GB
4570+\- type: article\-journal
4571+ id: WatsonCrick1953
4572+ author:
4573+ \- family: Watson
4574+ given: J. D.
4575+ \- family: Crick
4576+ given: F. H. C.
4577+ issued:
4578+ date\-parts:
4579+ \- \- 1953
4580+ \- 4
4581+ \- 25
4582+ title: \[aq]Molecular structure of nucleic acids: a structure for deoxyribose
4583+ nucleic acid\[aq]
4584+ title\-short: Molecular structure of nucleic acids
4585+ container\-title: Nature
4586+ volume: 171
4587+ issue: 4356
4588+ page: 737\-738
4589+ DOI: 10.1038/171737a0
4590+ URL: http://www.nature.com/nature/journal/v171/n4356/abs/171737a0.html
4591+ language: en\-GB
45864592\&...
45874593\f[R]
45884594.fi
45894595.PP
4590−(\f[C]pandoc\-citeproc\ \-\-bib2yaml\f[R] can produce these from a
4596+(\f[C]pandoc\-citeproc \-\-bib2yaml\f[R] can produce these from a
45914597bibliography file in one of the supported formats.)
45924598.PP
45934599Citations and references can be formatted using any style supported by
@@ -4600,7 +4606,7 @@ The CSL project provides further information on finding and editing
46004606styles.
46014607.PP
46024608To make your citations hyperlinks to the corresponding bibliography
4603−entries, add \f[C]link\-citations:\ true\f[R] to your YAML metadata.
4609+entries, add \f[C]link\-citations: true\f[R] to your YAML metadata.
46044610.PP
46054611Citations go inside square brackets and are separated by semicolons.
46064612Each citation must have a key, composed of \[aq]\[at]\[aq] + the
@@ -4613,11 +4619,11 @@ Here are some examples:
46134619.IP
46144620.nf
46154621\f[C]
4616−Blah\ blah\ [see\ \[at]doe99,\ pp.\ 33\-35;\ also\ \[at]smith04,\ chap.\ 1].
4622+Blah blah [see \[at]doe99, pp. 33\-35; also \[at]smith04, chap. 1].
46174623
4618−Blah\ blah\ [\[at]doe99,\ pp.\ 33\-35,\ 38\-39\ and\ *passim*].
4624+Blah blah [\[at]doe99, pp. 33\-35, 38\-39 and *passim*].
46194625
4620−Blah\ blah\ [\[at]smith04;\ \[at]doe99].
4626+Blah blah [\[at]smith04; \[at]doe99].
46214627\f[R]
46224628.fi
46234629.PP
@@ -4637,7 +4643,7 @@ singular or plural forms, as \f[C]book\f[R],
46374643\f[C]p.\f[R]/\f[C]pp.\f[R]; \f[C]paragraph\f[R],
46384644\f[C]para.\f[R]/\f[C]paras.\f[R]; \f[C]part\f[R],
46394645\f[C]pt.\f[R]/\f[C]pts.\f[R]; \f[C]section\f[R],
4640−\f[C]sec.\f[R]/\f[C]secs.\f[R]; \f[C]sub\ verbo\f[R],
4646+\f[C]sec.\f[R]/\f[C]secs.\f[R]; \f[C]sub verbo\f[R],
46414647\f[C]s.v.\f[R]/\f[C]s.vv.\f[R]; \f[C]verse\f[R],
46424648\f[C]v.\f[R]/\f[C]vv.\f[R]; \f[C]volume\f[R],
46434649\f[C]vol.\f[R]/\f[C]vols.\f[R]; \f[C]\[ps]\f[R]/\f[C]\[ps]\[ps]\f[R];
@@ -4650,7 +4656,7 @@ This can be useful when the author is already mentioned in the text:
46504656.IP
46514657.nf
46524658\f[C]
4653−Smith\ says\ blah\ [\-\[at]smith04].
4659+Smith says blah [\-\[at]smith04].
46544660\f[R]
46554661.fi
46564662.PP
@@ -4658,9 +4664,9 @@ You can also write an in\-text citation, as follows:
46584664.IP
46594665.nf
46604666\f[C]
4661−\[at]smith04\ says\ blah.
4667+\[at]smith04 says blah.
46624668
4663−\[at]smith04\ [p.\ 33]\ says\ blah.
4669+\[at]smith04 [p. 33] says blah.
46644670\f[R]
46654671.fi
46664672.PP
@@ -4670,9 +4676,9 @@ Normally, you will want to end your document with an appropriate header:
46704676.IP
46714677.nf
46724678\f[C]
4673−last\ paragraph...
4679+last paragraph...
46744680
4675−#\ References
4681+# References
46764682\f[R]
46774683.fi
46784684.PP
@@ -4687,8 +4693,8 @@ field and put the citations there:
46874693.nf
46884694\f[C]
46894695\-\-\-
4690−nocite:\ |
4691−\ \ \[at]item1,\ \[at]item2
4696+nocite: |
4697+ \[at]item1, \[at]item2
46924698\&...
46934699
46944700\[at]item3
@@ -4705,8 +4711,8 @@ or not they appear in the document, by using a wildcard:
47054711.nf
47064712\f[C]
47074713\-\-\-
4708−nocite:\ |
4709−\ \ \[at]*
4714+nocite: |
4715+ \[at]*
47104716\&...
47114717\f[R]
47124718.fi
@@ -4754,7 +4760,7 @@ example,
47544760.IP
47554761.nf
47564762\f[C]
4757−[foo]\ [bar].
4763+[foo] [bar].
47584764\f[R]
47594765.fi
47604766.SS Extension: \f[C]hard_line_breaks\f[R]
@@ -4805,11 +4811,11 @@ for example:
48054811.IP
48064812.nf
48074813\f[C]
4808−Title:\ \ \ My\ title
4809−Author:\ \ John\ Doe
4810−Date:\ \ \ \ September\ 1,\ 2008
4811−Comment:\ This\ is\ a\ sample\ mmd\ title\ block,\ with
4812−\ \ \ \ \ \ \ \ \ a\ field\ spanning\ multiple\ lines.
4814+Title: My title
4815+Author: John Doe
4816+Date: September 1, 2008
4817+Comment: This is a sample mmd title block, with
4818+ a field spanning multiple lines.
48134819\f[R]
48144820.fi
48154821.PP
@@ -4822,7 +4828,7 @@ Parses PHP Markdown Extra abbreviation keys, like
48224828.IP
48234829.nf
48244830\f[C]
4825−*[HTML]:\ Hypertext\ Markup\ Language
4831+*[HTML]: Hypertext Markup Language
48264832\f[R]
48274833.fi
48284834.PP
@@ -4842,10 +4848,10 @@ extension.
48424848.IP
48434849.nf
48444850\f[C]
4845−This\ is\ a\ reference\ ![image][ref]\ with\ multimarkdown\ attributes.
4851+This is a reference ![image][ref] with multimarkdown attributes.
48464852
4847−[ref]:\ http://path.to/image\ \[dq]Image\ title\[dq]\ width=20px\ height=30px
4848−\ \ \ \ \ \ \ id=myId\ class=\[dq]myClass1\ myClass2\[dq]
4853+[ref]: http://path.to/image \[dq]Image title\[dq] width=20px height=30px
4854+ id=myId class=\[dq]myClass1 myClass2\[dq]
48494855\f[R]
48504856.fi
48514857.SS Extension: \f[C]mmd_header_identifiers\f[R]
@@ -4937,37 +4943,37 @@ Here\[aq]s the Markdown source for a simple slide show,
49374943.IP
49384944.nf
49394945\f[C]
4940−%\ Habits
4941−%\ John\ Doe
4942−%\ March\ 22,\ 2005
4946+% Habits
4947+% John Doe
4948+% March 22, 2005
49434949
4944−#\ In\ the\ morning
4950+# In the morning
49454951
4946−##\ Getting\ up
4952+## Getting up
49474953
4948−\-\ Turn\ off\ alarm
4949−\-\ Get\ out\ of\ bed
4954+\- Turn off alarm
4955+\- Get out of bed
49504956
4951−##\ Breakfast
4957+## Breakfast
49524958
4953−\-\ Eat\ eggs
4954−\-\ Drink\ coffee
4959+\- Eat eggs
4960+\- Drink coffee
49554961
4956−#\ In\ the\ evening
4962+# In the evening
49574963
4958−##\ Dinner
4964+## Dinner
49594965
4960−\-\ Eat\ spaghetti
4961−\-\ Drink\ wine
4966+\- Eat spaghetti
4967+\- Drink wine
49624968
49634969\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
49644970
4965−
4971+
49664972
4967−##\ Going\ to\ sleep
4973+## Going to sleep
49684974
4969−\-\ Get\ in\ bed
4970−\-\ Count\ sheep
4975+\- Get in bed
4976+\- Count sheep
49714977\f[R]
49724978.fi
49734979.PP
@@ -4975,7 +4981,7 @@ To produce an HTML/JavaScript slide show, simply type
49754981.IP
49764982.nf
49774983\f[C]
4978−pandoc\ \-t\ FORMAT\ \-s\ habits.txt\ \-o\ habits.html
4984+pandoc \-t FORMAT \-s habits.txt \-o habits.html
49794985\f[R]
49804986.fi
49814987.PP
@@ -5003,7 +5009,7 @@ To produce a PDF slide show using beamer, type
50035009.IP
50045010.nf
50055011\f[C]
5006−pandoc\ \-t\ beamer\ habits.txt\ \-o\ habits.pdf
5012+pandoc \-t beamer habits.txt \-o habits.pdf
50075013\f[R]
50085014.fi
50095015.PP
@@ -5014,7 +5020,7 @@ To produce a Powerpoint slide show, type
50145020.IP
50155021.nf
50165022\f[C]
5017−pandoc\ habits.txt\ \-o\ habits.pptx
5023+pandoc habits.txt \-o habits.pptx
50185024\f[R]
50195025.fi
50205026.SS Structuring the slide show
@@ -5067,15 +5073,15 @@ a time), use the \f[C]\-i\f[R] option.
50675073If you want a particular list to depart from the default, put it in a
50685074\f[C]div\f[R] block with class \f[C]incremental\f[R] or
50695075\f[C]nonincremental\f[R].
5070−So, for example, using the \f[C]fenced\ div\f[R] syntax, the following
5076+So, for example, using the \f[C]fenced div\f[R] syntax, the following
50715077would be incremental regardless of the document default:
50725078.IP
50735079.nf
50745080\f[C]
5075−:::\ incremental
5081+::: incremental
50765082
5077−\-\ Eat\ spaghetti
5078−\-\ Drink\ wine
5083+\- Eat spaghetti
5084+\- Drink wine
50795085
50805086:::
50815087\f[R]
@@ -5085,10 +5091,10 @@ or
50855091.IP
50865092.nf
50875093\f[C]
5088−:::\ nonincremental
5094+::: nonincremental
50895095
5090−\-\ Eat\ spaghetti
5091−\-\ Drink\ wine
5096+\- Eat spaghetti
5097+\- Drink wine
50925098
50935099:::
50945100\f[R]
@@ -5103,8 +5109,8 @@ with the \f[C]\-i\f[R] option):
51035109.IP
51045110.nf
51055111\f[C]
5106−>\ \-\ Eat\ spaghetti
5107−>\ \-\ Drink\ wine
5112+> \- Eat spaghetti
5113+> \- Drink wine
51085114\f[R]
51095115.fi
51105116.PP
@@ -5117,13 +5123,13 @@ containing three dots, separated by spaces:
51175123.IP
51185124.nf
51195125\f[C]
5120−#\ Slide\ with\ a\ pause
5126+# Slide with a pause
51215127
5122−content\ before\ the\ pause
5128+content before the pause
51235129
5124−\&.\ .\ .
5130+\&. . .
51255131
5126−content\ after\ the\ pause
5132+content after the pause
51275133\f[R]
51285134.fi
51295135.SS Styling the slides
@@ -5146,7 +5152,7 @@ For example, themes can be used by setting the \f[C]theme\f[R] variable:
51465152.IP
51475153.nf
51485154\f[C]
5149−\-V\ theme=moon
5155+\-V theme=moon
51505156\f[R]
51515157.fi
51525158.PP
@@ -5159,7 +5165,7 @@ To style beamer slides, you can specify a \f[C]theme\f[R],
51595165.IP
51605166.nf
51615167\f[C]
5162−pandoc\ \-t\ beamer\ habits.txt\ \-V\ theme:Warsaw\ \-o\ habits.pdf
5168+pandoc \-t beamer habits.txt \-V theme:Warsaw \-o habits.pdf
51635169\f[R]
51645170.fi
51655171.PP
@@ -5174,7 +5180,7 @@ This is recommended especially for bibliographies:
51745180.IP
51755181.nf
51765182\f[C]
5177−#\ References\ {.allowframebreaks}
5183+# References {.allowframebreaks}
51785184\f[R]
51795185.fi
51805186.SS Speaker notes
@@ -5184,12 +5190,12 @@ You can add notes to your Markdown document thus:
51845190.IP
51855191.nf
51865192\f[C]
5187−:::\ notes
5193+::: notes
51885194
5189−This\ is\ my\ note.
5195+This is my note.
51905196
5191−\-\ It\ can\ contain\ Markdown
5192−\-\ like\ this\ list
5197+\- It can contain Markdown
5198+\- like this list
51935199
51945200:::
51955201\f[R]
@@ -5210,11 +5216,11 @@ containers with class \f[C]column\f[R] and a \f[C]width\f[R] attribute:
52105216.IP
52115217.nf
52125218\f[C]
5213−::::::::::::::\ {.columns}
5214−:::\ {.column\ width=\[dq]40%\[dq]}
5219+:::::::::::::: {.columns}
5220+::: {.column width=\[dq]40%\[dq]}
52155221contents...
52165222:::
5217−:::\ {.column\ width=\[dq]60%\[dq]}
5223+::: {.column width=\[dq]60%\[dq]}
52185224contents...
52195225:::
52205226::::::::::::::
@@ -5230,7 +5236,7 @@ introducing the slide:
52305236.IP
52315237.nf
52325238\f[C]
5233−#\ Fragile\ slide\ {.fragile}
5239+# Fragile slide {.fragile}
52345240\f[R]
52355241.fi
52365242.PP
@@ -5275,17 +5281,17 @@ For example in reveal.js:
52755281.nf
52765282\f[C]
52775283\-\-\-
5278−title:\ My\ Slideshow
5279−parallaxBackgroundImage:\ /path/to/my/background_image.png
5284+title: My Slideshow
5285+parallaxBackgroundImage: /path/to/my/background_image.png
52805286\-\-\-
52815287
5282−##\ Slide\ One
5288+## Slide One
52835289
5284−Slide\ 1\ has\ background_image.png\ as\ its\ background.
5290+Slide 1 has background_image.png as its background.
52855291
5286−##\ {data\-background\-image=\[dq]/path/to/special_image.jpg\[dq]}
5292+## {data\-background\-image=\[dq]/path/to/special_image.jpg\[dq]}
52875293
5288−Slide\ 2\ has\ a\ special\ image\ for\ its\ background,\ even\ though\ the\ header\ has\ no\ content.
5294+Slide 2 has a special image for its background, even though the header has no content.
52895295\f[R]
52905296.fi
52915297.SH CREATING EPUBS WITH PANDOC
@@ -5300,22 +5306,22 @@ Here is an example:
53005306\f[C]
53015307\-\-\-
53025308title:
5303−\-\ type:\ main
5304−\ \ text:\ My\ Book
5305−\-\ type:\ subtitle
5306−\ \ text:\ An\ investigation\ of\ metadata
5309+\- type: main
5310+ text: My Book
5311+\- type: subtitle
5312+ text: An investigation of metadata
53075313creator:
5308−\-\ role:\ author
5309−\ \ text:\ John\ Smith
5310−\-\ role:\ editor
5311−\ \ text:\ Sarah\ Jones
5314+\- role: author
5315+ text: John Smith
5316+\- role: editor
5317+ text: Sarah Jones
53125318identifier:
5313−\-\ scheme:\ DOI
5314−\ \ text:\ doi:10.234234.234/33
5315−publisher:\ \ My\ Press
5316−rights:\ \[co]\ 2007\ John\ Smith,\ CC\ BY\-NC
5319+\- scheme: DOI
5320+ text: doi:10.234234.234/33
5321+publisher: My Press
5322+rights: \[co] 2007 John Smith, CC BY\-NC
53175323ibooks:
5318−\ \ version:\ 1.3.4
5324+ version: 1.3.4
53195325\&...
53205326\f[R]
53215327.fi
@@ -5328,7 +5334,7 @@ Either a string value or an object with fields \f[C]text\f[R] and
53285334Valid values for \f[C]scheme\f[R] are \f[C]ISBN\-10\f[R],
53295335\f[C]GTIN\-13\f[R], \f[C]UPC\f[R], \f[C]ISMN\-10\f[R], \f[C]DOI\f[R],
53305336\f[C]LCCN\f[R], \f[C]GTIN\-14\f[R], \f[C]ISBN\-13\f[R],
5331−\f[C]Legal\ deposit\ number\f[R], \f[C]URN\f[R], \f[C]OCLC\f[R],
5337+\f[C]Legal deposit number\f[R], \f[C]URN\f[R], \f[C]OCLC\f[R],
53325338\f[C]ISMN\-13\f[R], \f[C]ISBN\-A\f[R], \f[C]JP\f[R], \f[C]OLCC\f[R].
53335339.TP
53345340.B \f[C]title\f[R]
@@ -5381,7 +5387,7 @@ A string value.
53815387.B \f[C]cover\-image\f[R]
53825388A string value (path to cover image).
53835389.TP
5384−.B \f[C]stylesheet\f[R]
5390+.B \f[C]css\f[R] (or legacy: \f[C]stylesheet\f[R])
53855391A string value (path to CSS stylesheet).
53865392.TP
53875393.B \f[C]page\-progression\-direction\f[R]
@@ -5419,7 +5425,7 @@ this markdown:
54195425.IP
54205426.nf
54215427\f[C]
5422−#\ My\ chapter\ {epub:type=prologue}
5428+# My chapter {epub:type=prologue}
54235429\f[R]
54245430.fi
54255431.PP
@@ -5427,13 +5433,13 @@ Which will result in:
54275433.IP
54285434.nf
54295435\f[C]
5430−<body\ epub:type=\[dq]frontmatter\[dq]>
5431−\ \ <section\ epub:type=\[dq]prologue\[dq]>
5432−\ \ \ \ <h1>My\ chapter</h1>
5436+<body epub:type=\[dq]frontmatter\[dq]>
5437+ <section epub:type=\[dq]prologue\[dq]>
5438+ <h1>My chapter</h1>
54335439\f[R]
54345440.fi
54355441.PP
5436−Pandoc will output \f[C]<body\ epub:type=\[dq]bodymatter\[dq]>\f[R],
5442+Pandoc will output \f[C]<body epub:type=\[dq]bodymatter\[dq]>\f[R],
54375443unless you use one of the following values, in which case either
54385444\f[C]frontmatter\f[R] or \f[C]backmatter\f[R] will be output.
54395445.PP
@@ -5540,10 +5546,10 @@ For example:
55405546.IP
55415547.nf
55425548\f[C]
5543−<audio\ controls=\[dq]1\[dq]>
5544−\ \ <source\ src=\[dq]http://example.com/music/toccata.mp3\[dq]
5545−\ \ \ \ \ \ \ \ \ \ data\-external=\[dq]1\[dq]\ type=\[dq]audio/mpeg\[dq]>
5546−\ \ </source>
5549+<audio controls=\[dq]1\[dq]>
5550+ <source src=\[dq]http://example.com/music/toccata.mp3\[dq]
5551+ data\-external=\[dq]1\[dq] type=\[dq]audio/mpeg\[dq]>
5552+ </source>
55475553</audio>
55485554\f[R]
55495555.fi
@@ -5555,7 +5561,7 @@ The Haskell library skylighting is used for highlighting.
55555561Currently highlighting is supported only for HTML, EPUB, Docx, Ms, and
55565562LaTeX/PDF output.
55575563To see a list of language names that pandoc will recognize, type
5558−\f[C]pandoc\ \-\-list\-highlight\-languages\f[R].
5564+\f[C]pandoc \-\-list\-highlight\-languages\f[R].
55595565.PP
55605566The color scheme can be selected using the
55615567\f[C]\-\-highlight\-style\f[R] option.
@@ -5563,17 +5569,17 @@ The default color scheme is \f[C]pygments\f[R], which imitates the
55635569default color scheme used by the Python library pygments (though
55645570pygments is not actually used to do the highlighting).
55655571To see a list of highlight styles, type
5566−\f[C]pandoc\ \-\-list\-highlight\-styles\f[R].
5572+\f[C]pandoc \-\-list\-highlight\-styles\f[R].
55675573.PP
55685574If you are not satisfied with the predefined styles, you can use
55695575\f[C]\-\-print\-highlight\-style\f[R] to generate a JSON
5570−\f[C]\&.theme\f[R] file which can be modified and used as the argument
5571−to \f[C]\-\-highlight\-style\f[R].
5576+\f[C].theme\f[R] file which can be modified and used as the argument to
5577+\f[C]\-\-highlight\-style\f[R].
55725578To get a JSON version of the \f[C]pygments\f[R] style, for example:
55735579.IP
55745580.nf
55755581\f[C]
5576−pandoc\ \-\-print\-highlight\-style\ pygments\ >\ my.theme
5582+pandoc \-\-print\-highlight\-style pygments > my.theme
55775583\f[R]
55785584.fi
55795585.PP
@@ -5581,7 +5587,7 @@ Then edit \f[C]my.theme\f[R] and use it like this:
55815587.IP
55825588.nf
55835589\f[C]
5584−pandoc\ \-\-highlight\-style\ my.theme
5590+pandoc \-\-highlight\-style my.theme
55855591\f[R]
55865592.fi
55875593.PP
@@ -5601,7 +5607,7 @@ into pandoc elements, either by direct conversion or interpreting the
56015607derivation of the input document\[aq]s styles.
56025608.PP
56035609By enabling the \f[C]styles\f[R] extension in the docx reader
5604−(\f[C]\-f\ docx+styles\f[R]), you can produce output that maintains the
5610+(\f[C]\-f docx+styles\f[R]), you can produce output that maintains the
56055611styles of the input document, using the \f[C]custom\-style\f[R] class.
56065612Paragraph styles are interpreted as divs, while character styles are
56075613interpreted as spans.
@@ -5613,13 +5619,13 @@ Without the \f[C]+styles\f[R] extension:
56135619.IP
56145620.nf
56155621\f[C]
5616−$\ pandoc\ test/docx/custom\-style\-reference.docx\ \-f\ docx\ \-t\ markdown
5617−This\ is\ some\ text.
5622+$ pandoc test/docx/custom\-style\-reference.docx \-f docx \-t markdown
5623+This is some text.
56185624
5619−This\ is\ text\ with\ an\ *emphasized*\ text\ style.\ And\ this\ is\ text\ with\ a
5620−**strengthened**\ text\ style.
5625+This is text with an *emphasized* text style. And this is text with a
5626+**strengthened** text style.
56215627
5622−>\ Here\ is\ a\ styled\ paragraph\ that\ inherits\ from\ Block\ Text.
5628+> Here is a styled paragraph that inherits from Block Text.
56235629\f[R]
56245630.fi
56255631.PP
@@ -5627,20 +5633,20 @@ And with the extension:
56275633.IP
56285634.nf
56295635\f[C]
5630−$\ pandoc\ test/docx/custom\-style\-reference.docx\ \-f\ docx+styles\ \-t\ markdown
5636+$ pandoc test/docx/custom\-style\-reference.docx \-f docx+styles \-t markdown
56315637
5632−:::\ {custom\-style=\[dq]FirstParagraph\[dq]}
5633−This\ is\ some\ text.
5638+::: {custom\-style=\[dq]FirstParagraph\[dq]}
5639+This is some text.
56345640:::
56355641
5636−:::\ {custom\-style=\[dq]BodyText\[dq]}
5637−This\ is\ text\ with\ an\ [emphasized]{custom\-style=\[dq]Emphatic\[dq]}\ text\ style.
5638−And\ this\ is\ text\ with\ a\ [strengthened]{custom\-style=\[dq]Strengthened\[dq]}
5639−text\ style.
5642+::: {custom\-style=\[dq]BodyText\[dq]}
5643+This is text with an [emphasized]{custom\-style=\[dq]Emphatic\[dq]} text style.
5644+And this is text with a [strengthened]{custom\-style=\[dq]Strengthened\[dq]}
5645+text style.
56405646:::
56415647
5642−:::\ {custom\-style=\[dq]MyBlockStyle\[dq]}
5643−>\ Here\ is\ a\ styled\ paragraph\ that\ inherits\ from\ Block\ Text.
5648+::: {custom\-style=\[dq]MyBlockStyle\[dq]}
5649+> Here is a styled paragraph that inherits from Block Text.
56445650:::
56455651\f[R]
56465652.fi
@@ -5666,7 +5672,7 @@ So, for example using the \f[C]bracketed_spans\f[R] syntax,
56665672.IP
56675673.nf
56685674\f[C]
5669−[Get\ out]{custom\-style=\[dq]Emphatically\[dq]},\ he\ said.
5675+[Get out]{custom\-style=\[dq]Emphatically\[dq]}, he said.
56705676\f[R]
56715677.fi
56725678.PP
@@ -5676,11 +5682,11 @@ Similarly, using the \f[C]fenced_divs\f[R] syntax,
56765682.IP
56775683.nf
56785684\f[C]
5679−Dickinson\ starts\ the\ poem\ simply:
5685+Dickinson starts the poem simply:
56805686
5681−:::\ {custom\-style=\[dq]Poetry\[dq]}
5682−|\ A\ Bird\ came\ down\ the\ Walk\-\-\-
5683−|\ He\ did\ not\ know\ I\ saw\-\-\-
5687+::: {custom\-style=\[dq]Poetry\[dq]}
5688+| A Bird came down the Walk\-\-\-
5689+| He did not know I saw\-\-\-
56845690:::
56855691\f[R]
56865692.fi
@@ -5712,7 +5718,7 @@ For example:
57125718.IP
57135719.nf
57145720\f[C]
5715−pandoc\ \-t\ data/sample.lua
5721+pandoc \-t data/sample.lua
57165722\f[R]
57175723.fi
57185724.PP
@@ -5723,7 +5729,7 @@ needs, do
57235729.IP
57245730.nf
57255731\f[C]
5726−pandoc\ \-\-print\-default\-data\-file\ sample.lua
5732+pandoc \-\-print\-default\-data\-file sample.lua
57275733\f[R]
57285734.fi
57295735.SH AUTHORS