@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "January 7, 2018" "pandoc 2.1"
2+.TH PANDOC 1 "January 7, 2018" "pandoc 2.1.1"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -307,28 +307,16 @@ If this option is not specified, the default user data directory will be
307307used.
308308This is, in UNIX:
309309.RS
310−.IP
311−.nf
312−\f[C]
310+.PP
313311$HOME/.pandoc
314−\f[]
315−.fi
316312.PP
317313in Windows XP:
318−.IP
319−.nf
320−\f[C]
321−C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\pandoc
322−\f[]
323−.fi
314+.PP
315+C:And SettingsData
324316.PP
325317and in Windows Vista or later:
326−.IP
327−.nf
328−\f[C]
329−C:\\Users\\USERNAME\\AppData\\Roaming\\pandoc
330−\f[]
331−.fi
318+.PP
319+C:
332320.PP
333321You can find the default user data directory on your system by looking
334322at the output of \f[C]pandoc\ \-\-version\f[].
@@ -343,12 +331,8 @@ Generate a bash completion script.
343331To enable bash completion with pandoc, add this to your
344332\f[C]\&.bashrc\f[]:
345333.RS
346−.IP
347−.nf
348−\f[C]
349−\ eval\ "$(pandoc\ \-\-bash\-completion)"
350−\f[]
351−.fi
334+.PP
335+eval "$(pandoc \-\-bash\-completion)"
352336.RE
353337.TP
354338.B \f[C]\-\-verbose\f[]
@@ -462,20 +446,12 @@ The name of the output format will be passed to the filter as the first
462446argument.
463447Hence,
464448.RS
465−.IP
466−.nf
467−\f[C]
468−pandoc\ \-\-filter\ ./caps.py\ \-t\ latex
469−\f[]
470−.fi
449+.PP
450+pandoc \-\-filter ./caps.py \-t latex
471451.PP
472452is equivalent to
473−.IP
474−.nf
475−\f[C]
476−pandoc\ \-t\ json\ |\ ./caps.py\ latex\ |\ pandoc\ \-f\ json\ \-t\ latex
477−\f[]
478−.fi
453+.PP
454+pandoc \-t json | ./caps.py latex | pandoc \-f json \-t latex
479455.PP
480456The latter form may be useful for debugging filters.
481457.PP
@@ -517,20 +493,12 @@ creation.
517493It is always loaded into the script\[aq]s lua environment.
518494.PP
519495The following is an example lua script for macro\-expansion:
520−.IP
521−.nf
522−\f[C]
523−function\ expand_hello_world(inline)
524−\ \ if\ inline.c\ ==\ \[aq]{{helloworld}}\[aq]\ then
525−\ \ \ \ return\ pandoc.Emph{\ pandoc.Str\ "Hello,\ World"\ }
526−\ \ else
527−\ \ \ \ return\ inline
528−\ \ end
529−end
530−
531−return\ {{Str\ =\ expand_hello_world}}
532−\f[]
533−.fi
496+.PP
497+function expand_hello_world(inline) if inline.c ==
498+\[aq]{{helloworld}}\[aq] then return pandoc.Emph{ pandoc.Str "Hello,
499+World" } else return inline end end
500+.PP
501+return {{Str = expand_hello_world}}
534502.RE
535503.TP
536504.B \f[C]\-M\f[] \f[I]KEY\f[][\f[C]=\f[]\f[I]VAL\f[]], \f[C]\-\-metadata=\f[]\f[I]KEY\f[][\f[C]:\f[]\f[I]VAL\f[]]
@@ -1010,6 +978,7 @@ for a file \f[C]reference.docx\f[] in the user data directory (see
1010978\f[C]\-\-data\-dir\f[]).
1011979If this is not found either, sensible defaults will be used.
1012980.RS
981+.RE
1013982.PP
1014983To produce a custom \f[C]reference.docx\f[], first get a copy of the
1015984default \f[C]reference.docx\f[]:
@@ -1025,7 +994,6 @@ Definition Term, Definition, Caption, Table Caption, Image Caption,
1025994Figure, Captioned Figure, TOC Heading; [character] Default Paragraph
1026995Font, Body Text Char, Verbatim Char, Footnote Reference, Hyperlink;
1027996[table] Table.
1028−.RE
1029997.TP
1030998.B ODT
1031999For best results, the reference ODT should be a modified version of an
@@ -1037,6 +1005,7 @@ for a file \f[C]reference.odt\f[] in the user data directory (see
10371005\f[C]\-\-data\-dir\f[]).
10381006If this is not found either, sensible defaults will be used.
10391007.RS
1008+.RE
10401009.PP
10411010To produce a custom \f[C]reference.odt\f[], first get a copy of the
10421011default \f[C]reference.odt\f[]:
@@ -1044,7 +1013,6 @@ default \f[C]reference.odt\f[]:
10441013Then open \f[C]custom\-reference.odt\f[] in LibreOffice, modify the
10451014styles as you wish, and save the file.
10461015.RE
1047−.RE
10481016.TP
10491017.B \f[C]\-\-epub\-cover\-image=\f[]\f[I]FILE\f[]
10501018Use the specified image as the EPUB cover.
@@ -1061,13 +1029,8 @@ Look in the specified XML file for metadata for the EPUB.
10611029The file should contain a series of Dublin Core elements.
10621030For example:
10631031.RS
1064−.IP
1065−.nf
1066−\f[C]
1067−\ <dc:rights>Creative\ Commons</dc:rights>
1068−\ <dc:language>es\-AR</dc:language>
1069−\f[]
1070−.fi
1032+.PP
1033+Creative Commons es\-AR
10711034.PP
10721035By default, pandoc will include the following metadata elements:
10731036\f[C]<dc:title>\f[] (from the document title), \f[C]<dc:creator>\f[]
@@ -1092,36 +1055,16 @@ being interpreted by the shell.
10921055To use the embedded fonts, you will need to add declarations like the
10931056following to your CSS (see \f[C]\-\-css\f[]):
10941057.RS
1095−.IP
1096−.nf
1097−\f[C]
1098−\@font\-face\ {
1099−font\-family:\ DejaVuSans;
1100−font\-style:\ normal;
1101−font\-weight:\ normal;
1102−src:url("DejaVuSans\-Regular.ttf");
1103−}
1104−\@font\-face\ {
1105−font\-family:\ DejaVuSans;
1106−font\-style:\ normal;
1107−font\-weight:\ bold;
1108−src:url("DejaVuSans\-Bold.ttf");
1109−}
1110−\@font\-face\ {
1111−font\-family:\ DejaVuSans;
1112−font\-style:\ italic;
1113−font\-weight:\ normal;
1114−src:url("DejaVuSans\-Oblique.ttf");
1115−}
1116−\@font\-face\ {
1117−font\-family:\ DejaVuSans;
1118−font\-style:\ italic;
1119−font\-weight:\ bold;
1120−src:url("DejaVuSans\-BoldOblique.ttf");
1121−}
1122−body\ {\ font\-family:\ "DejaVuSans";\ }
1123−\f[]
1124−.fi
1058+.PP
1059+\@font\-face { font\-family: DejaVuSans; font\-style: normal;
1060+font\-weight: normal; src:url("DejaVuSans\-Regular.ttf"); } \@font\-face
1061+{ font\-family: DejaVuSans; font\-style: normal; font\-weight: bold;
1062+src:url("DejaVuSans\-Bold.ttf"); } \@font\-face { font\-family:
1063+DejaVuSans; font\-style: italic; font\-weight: normal;
1064+src:url("DejaVuSans\-Oblique.ttf"); } \@font\-face { font\-family:
1065+DejaVuSans; font\-style: italic; font\-weight: bold;
1066+src:url("DejaVuSans\-BoldOblique.ttf"); } body { font\-family:
1067+"DejaVuSans"; }
11251068.RE
11261069.TP
11271070.B \f[C]\-\-epub\-chapter\-level=\f[]\f[I]NUMBER\f[]
@@ -1306,14 +1249,10 @@ The resulting HTML can then be processed by gladTeX to produce images of
13061249the typeset formulas and an HTML file with links to these images.
13071250So, the procedure is:
13081251.RS
1309−.IP
1310−.nf
1311−\f[C]
1312−pandoc\ \-s\ \-\-gladtex\ input.md\ \-o\ myfile.htex
1313−gladtex\ \-d\ myfile\-images\ myfile.htex
1314−#\ produces\ myfile.html\ and\ images\ in\ myfile\-images
1315−\f[]
1316−.fi
1252+.PP
1253+pandoc \-s \-\-gladtex input.md \-o myfile.htex gladtex \-d
1254+myfile\-images myfile.htex # produces myfile.html and images in
1255+myfile\-images
13171256.RE
13181257.TP
13191258.B \f[C]\-\-mimetex\f[][\f[C]=\f[]\f[I]URL\f[]]
@@ -1346,20 +1285,12 @@ Ignore command\-line arguments (for use in wrapper scripts).
13461285Regular pandoc options are not ignored.
13471286Thus, for example,
13481287.RS
1349−.IP
1350−.nf
1351−\f[C]
1352−pandoc\ \-\-ignore\-args\ \-o\ foo.html\ \-s\ foo.txt\ \-\-\ \-e\ latin1
1353−\f[]
1354−.fi
1288+.PP
1289+pandoc \-\-ignore\-args \-o foo.html \-s foo.txt \-\- \-e latin1
13551290.PP
13561291is equivalent to
1357−.IP
1358−.nf
1359−\f[C]
1360−pandoc\ \-o\ foo.html\ \-s
1361−\f[]
1362−.fi
1292+.PP
1293+pandoc \-o foo.html \-s
13631294.RE
13641295.SH TEMPLATES
13651296.PP
@@ -1413,18 +1344,13 @@ source and destination filenames, as given on the command line.
14131344files, or empty if input is from stdin.
14141345You can use the following snippet in your template to distinguish them:
14151346.RS
1416−.IP
1417−.nf
1418−\f[C]
1419−$if(sourcefile)$
1420−$for(sourcefile)$
1421−$sourcefile$
1422−$endfor$
1423−$else$
1424−(stdin)
1425−$endif$
1426−\f[]
1427−.fi
1347+.PP
1348+\f[I]i\f[]\f[I]f\f[](\f[I]s\f[]\f[I]o\f[]\f[I]u\f[]\f[I]r\f[]\f[I]c\f[]\f[I]e\f[]\f[I]f\f[]\f[I]i\f[]\f[I]l\f[]\f[I]e\f[])
1349+\f[I]f\f[]\f[I]o\f[]\f[I]r\f[](\f[I]s\f[]\f[I]o\f[]\f[I]u\f[]\f[I]r\f[]\f[I]c\f[]\f[I]e\f[]\f[I]f\f[]\f[I]i\f[]\f[I]l\f[]\f[I]e\f[])
1350+\f[I]s\f[]\f[I]o\f[]\f[I]u\f[]\f[I]r\f[]\f[I]c\f[]\f[I]e\f[]\f[I]f\f[]\f[I]i\f[]\f[I]l\f[]\f[I]e\f[]
1351+\f[I]e\f[]\f[I]n\f[]\f[I]d\f[]\f[I]f\f[]\f[I]o\f[]\f[I]r\f[]
1352+\f[I]e\f[]\f[I]l\f[]\f[I]s\f[]\f[I]e\f[] (stdin)
1353+\f[I]e\f[]\f[I]n\f[]\f[I]d\f[]\f[I]i\f[]\f[I]f\f[]
14281354.PP
14291355Similarly, \f[C]outputfile\f[] can be \f[C]\-\f[] if output goes to the
14301356terminal.
@@ -1436,16 +1362,6 @@ Included in PDF metadata through LaTeX and ConTeXt.
14361362These can be set through a pandoc title block, which allows for multiple
14371363authors, or through a YAML metadata block:
14381364.RS
1439−.IP
1440−.nf
1441−\f[C]
1442−\-\-\-
1443−author:
1444−\-\ Aristotle
1445−\-\ Peter\ Abelard
1446−\&...
1447−\f[]
1448−.fi
14491365.RE
14501366.TP
14511367.B \f[C]subtitle\f[]
@@ -1487,7 +1403,7 @@ specified
14871403.TP
14881404.B \f[C]toc\-title\f[]
14891405title of table of contents (works only with EPUB, opendocument, odt,
1490−docx)
1406+docx, pptx)
14911407.RS
14921408.RE
14931409.TP
@@ -1524,23 +1440,12 @@ stored in the additional variables \f[C]babel\-lang\f[],
15241440\f[C]polyglossia\-lang\f[] (LaTeX) and \f[C]context\-lang\f[] (ConTeXt).
15251441.RS
15261442.PP
1527−Native pandoc \f[C]span\f[]s and \f[C]div\f[]s with the lang attribute
1528−(value in BCP 47) can be used to switch the language in that range.
1529−.RE
1530−.TP
1531−.B \f[C]otherlangs\f[]
1532−a list of other languages used in the document in the YAML metadata,
1533−according to BCP 47.
1534−For example: \f[C]otherlangs:\ [en\-GB,\ fr]\f[].
1535−This is automatically generated from the \f[C]lang\f[] attributes in all
1536−\f[C]span\f[]s and \f[C]div\f[]s but can be overridden.
1537−Currently only used by LaTeX through the generated
1538−\f[C]babel\-otherlangs\f[] and \f[C]polyglossia\-otherlangs\f[]
1539−variables.
1540−The LaTeX writer outputs polyglossia commands in the text but the
1541−\f[C]babel\-newcommands\f[] variable contains mappings for them to the
1542−corresponding babel.
1543−.RS
1443+Native pandoc Spans and Divs with the lang attribute (value in BCP 47)
1444+can be used to switch the language in that range.
1445+In LaTeX output, \f[C]babel\-otherlangs\f[] and
1446+\f[C]polyglossia\-otherlangs\f[] variables will be generated
1447+automatically based on the \f[C]lang\f[] attributes of Spans and Divs in
1448+the document.
15441449.RE
15451450.TP
15461451.B \f[C]dir\f[]
@@ -2360,6 +2265,12 @@ to Emacs Muse markup.
23602265.PP
23612266Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted
23622267in \f[C]org\f[] input.
2268+.SS Extension: \f[C]ntb\f[]
2269+.PP
2270+In the \f[C]context\f[] output format this enables the use of Natural
2271+Tables (TABLE) instead of the default Extreme Tables (xtables).
2272+Natural tables allow more fine\-grained global customization but come at
2273+a performance penalty compared to extreme tables.
23632274.SH PANDOC\[aq]S MARKDOWN
23642275.PP
23652276Pandoc understands an extended and slightly revised version of John
@@ -2677,9 +2588,9 @@ For example,
26772588.IP
26782589.nf
26792590\f[C]
2680−\ \ \ \ if\ (a\ >\ 3)\ {
2681−\ \ \ \ \ \ moveShip(5\ *\ gravity,\ DOWN);
2682−\ \ \ \ }
2591+if\ (a\ >\ 3)\ {
2592+\ \ moveShip(5\ *\ gravity,\ DOWN);
2593+}
26832594\f[]
26842595.fi
26852596.PP
@@ -2736,7 +2647,7 @@ using this syntax:
27362647~~~~\ {#mycode\ .haskell\ .numberLines\ startFrom="100"}
27372648qsort\ []\ \ \ \ \ =\ []
27382649qsort\ (x:xs)\ =\ qsort\ (filter\ (<\ x)\ xs)\ ++\ [x]\ ++
2739−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ qsort\ (filter\ (>=\ x)\ xs)
2650+\ \ \ \ \ \ \ qsort\ (filter\ (>=\ x)\ xs)
27402651~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
27412652\f[]
27422653.fi
@@ -2898,12 +2809,12 @@ marker.
28982809\f[C]
28992810\ \ *\ First\ paragraph.
29002811
2901−\ \ \ \ Continued.
2812+Continued.
29022813
29032814\ \ *\ Second\ paragraph.\ With\ a\ code\ block,\ which\ must\ be\ indented
2904−\ \ \ \ eight\ spaces:
2815+eight\ spaces:
29052816
2906−\ \ \ \ \ \ \ \ {\ code\ }
2817+\ \ \ \ {\ code\ }
29072818\f[]
29082819.fi
29092820.PP
@@ -2929,8 +2840,8 @@ character after the list marker of the containing list item.
29292840\f[C]
29302841*\ fruits
29312842\ \ +\ apples
2932−\ \ \ \ \-\ macintosh
2933−\ \ \ \ \-\ red\ delicious
2843+\-\ macintosh
2844+\-\ red\ delicious
29342845\ \ +\ pears
29352846\ \ +\ peaches
29362847*\ vegetables
@@ -2952,7 +2863,7 @@ item.
29522863+\ Another\ one;\ this\ looks
29532864bad\ but\ is\ legal.
29542865
2955−\ \ \ \ Second\ paragraph\ of\ second
2866+Second\ paragraph\ of\ second
29562867list\ item.
29572868\f[]
29582869.fi
@@ -3017,9 +2928,9 @@ numerals:
30172928\ 9)\ \ Ninth
3018292910)\ \ Tenth
3019293011)\ \ Eleventh
3020−\ \ \ \ \ \ \ i.\ subone
3021−\ \ \ \ \ \ ii.\ subtwo
3022−\ \ \ \ \ iii.\ subthree
2931+\ \ \ i.\ subone
2932+\ \ ii.\ subtwo
2933+\ iii.\ subthree
30232934\f[]
30242935.fi
30252936.PP
@@ -3061,9 +2972,9 @@ Term\ 2\ with\ *inline\ markup*
30612972
30622973:\ \ \ Definition\ 2
30632974
3064−\ \ \ \ \ \ \ \ {\ some\ code,\ part\ of\ Definition\ 2\ }
2975+\ \ \ \ {\ some\ code,\ part\ of\ Definition\ 2\ }
30652976
3066−\ \ \ \ Third\ paragraph\ of\ definition\ 2.
2977+Third\ paragraph\ of\ definition\ 2.
30672978\f[]
30682979.fi
30692980.PP
@@ -3087,7 +2998,7 @@ Term\ 1
30872998:\ \ \ Definition
30882999with\ lazy\ continuation.
30893000
3090−\ \ \ \ Second\ paragraph\ of\ the\ definition.
3001+Second\ paragraph\ of\ the\ definition.
30913002\f[]
30923003.fi
30933004.PP
@@ -3165,9 +3076,9 @@ Consider this source:
31653076\f[C]
31663077+\ \ \ First
31673078+\ \ \ Second:
3168−\ \ \ \ \-\ \ \ Fee
3169−\ \ \ \ \-\ \ \ Fie
3170−\ \ \ \ \-\ \ \ Foe
3079+\-\ \ \ Fee
3080+\-\ \ \ Fie
3081+\-\ \ \ Foe
31713082
31723083+\ \ \ Third
31733084\f[]
@@ -3196,7 +3107,7 @@ What if you want to put an indented code block after a list?
31963107\-\ \ \ item\ one
31973108\-\ \ \ item\ two
31983109
3199−\ \ \ \ {\ my\ code\ block\ }
3110+{\ my\ code\ block\ }
32003111\f[]
32013112.fi
32023113.PP
@@ -3215,7 +3126,7 @@ any format:
32153126
32163127<!\-\-\ end\ of\ list\ \-\->
32173128
3218−\ \ \ \ {\ my\ code\ block\ }
3129+{\ my\ code\ block\ }
32193130\f[]
32203131.fi
32213132.PP
@@ -3270,9 +3181,9 @@ Simple tables look like this:
32703181\f[C]
32713182\ \ Right\ \ \ \ \ Left\ \ \ \ \ Center\ \ \ \ \ Default
32723183\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
3273−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ 12
3274−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ 123
3275−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ 1
3184+\ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ 12
3185+123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ 123
3186+\ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ 1
32763187
32773188Table:\ \ Demonstration\ of\ simple\ table\ syntax.
32783189\f[]
@@ -3304,9 +3215,9 @@ For example:
33043215.nf
33053216\f[C]
33063217\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
3307−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ \ 12
3308−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ \ 123
3309−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ \ 1
3218+\ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ \ 12
3219+123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ \ 123
3220+\ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ \ 1
33103221\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-
33113222\f[]
33123223.fi
@@ -3329,11 +3240,11 @@ Here is an example:
33293240\ \ Header\ \ \ \ Aligned\ \ \ \ \ \ \ \ \ Aligned\ Aligned
33303241\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
33313242\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that
3332−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
3243+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
33333244
33343245\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note
3335−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3336−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
3246+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3247+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
33373248\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
33383249
33393250Table:\ Here\[aq]s\ the\ caption.\ It,\ too,\ may\ span
@@ -3362,11 +3273,11 @@ Headers may be omitted in multiline tables as well as simple tables:
33623273\f[C]
33633274\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
33643275\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that
3365−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
3276+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.
33663277
33673278\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note
3368−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3369−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
3279+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between
3280+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.
33703281\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
33713282
33723283:\ Here\[aq]s\ a\ multiline\ table\ without\ headers.
@@ -3714,6 +3625,23 @@ $endif$
37143625$endfor$
37153626\f[]
37163627.fi
3628+.PP
3629+Raw content to include in the document\[aq]s header may be specified
3630+using \f[C]header\-includes\f[]; however, it is important to mark up
3631+this content as raw code for a particular output format, using the
3632+\f[C]raw_attribute\f[] extension), or it will be interpreted as
3633+markdown.
3634+For example:
3635+.IP
3636+.nf
3637+\f[C]
3638+header\-includes:
3639+\-\ ```{=latex}
3640+\ \ \\let\\oldsection\\section
3641+\ \ \\renewcommand{\\section}[1]{\\clearpage\\oldsection{#1}}
3642+\ \ ```
3643+\f[]
3644+.fi
37173645.SS Backslash escapes
37183646.SS Extension: \f[C]all_symbols_escapable\f[]
37193647.PP
@@ -4157,13 +4085,15 @@ $\\tuple{a,\ b,\ c}$
41574085\f[]
41584086.fi
41594087.PP
4160−In LaTeX output, the macro definitions will not be passed through as raw
4161−LaTeX.
4088+Note that LaTeX macros will not be applied if they occur inside inside a
4089+raw span or block marked with the \f[C]raw_attribute\f[] extension.
41624090.PP
4163−When \f[C]latex_macros\f[] is disabled, the macro definitions will be
4164−passed through as raw LaTeX, and the raw LaTeX and math will not have
4165−macros applied.
4091+When \f[C]latex_macros\f[] is disabled, the raw LaTeX and math will not
4092+have macros applied.
41664093This is usually a better approach when you are targeting LaTeX or PDF.
4094+.PP
4095+Whether or not \f[C]latex_macros\f[] is enabled, the macro definitions
4096+will still be passed through as raw LaTeX.
41674097.SS Links
41684098.PP
41694099Markdown allows links to be specified in several ways.
@@ -4359,7 +4289,7 @@ One way to do this is to insert a nonbreaking space after the image:
43594289.IP
43604290.nf
43614291\f[C]
4362−![This\ image\ won\[aq]t\ be\ a\ figure](/url/of/image.png)\\\
4292+![This\ image\ won\[aq]t\ be\ a\ figure](/url/of/image.png)\\
43634293\f[]
43644294.fi
43654295.PP
@@ -4501,14 +4431,14 @@ Here\ is\ a\ footnote\ reference,[^1]\ and\ another.[^longnote]
45014431
45024432[^longnote]:\ Here\[aq]s\ one\ with\ multiple\ blocks.
45034433
4504−\ \ \ \ Subsequent\ paragraphs\ are\ indented\ to\ show\ that\ they
4434+Subsequent\ paragraphs\ are\ indented\ to\ show\ that\ they
45054435belong\ to\ the\ previous\ footnote.
45064436
4507−\ \ \ \ \ \ \ \ {\ some.code\ }
4437+\ \ \ \ {\ some.code\ }
45084438
4509−\ \ \ \ The\ whole\ paragraph\ can\ be\ indented,\ or\ just\ the\ first
4510−\ \ \ \ line.\ \ In\ this\ way,\ multi\-paragraph\ footnotes\ work\ like
4511−\ \ \ \ multi\-paragraph\ list\ items.
4439+The\ whole\ paragraph\ can\ be\ indented,\ or\ just\ the\ first
4440+line.\ \ In\ this\ way,\ multi\-paragraph\ footnotes\ work\ like
4441+multi\-paragraph\ list\ items.
45124442
45134443This\ paragraph\ won\[aq]t\ be\ part\ of\ the\ note,\ because\ it
45144444isn\[aq]t\ indented.
@@ -4687,16 +4617,16 @@ references:
46874617\ \ id:\ WatsonCrick1953
46884618\ \ author:
46894619\ \ \-\ family:\ Watson
4690−\ \ \ \ given:\ J.\ D.
4620+given:\ J.\ D.
46914621\ \ \-\ family:\ Crick
4692−\ \ \ \ given:\ F.\ H.\ C.
4622+given:\ F.\ H.\ C.
46934623\ \ issued:
4694−\ \ \ \ date\-parts:
4695−\ \ \ \ \-\ \-\ 1953
4696−\ \ \ \ \ \ \-\ 4
4697−\ \ \ \ \ \ \-\ 25
4624+date\-parts:
4625+\-\ \-\ 1953
4626+\ \ \-\ 4
4627+\ \ \-\ 25
46984628\ \ title:\ \[aq]Molecular\ structure\ of\ nucleic\ acids:\ a\ structure\ for\ deoxyribose
4699−\ \ \ \ nucleic\ acid\[aq]
4629+nucleic\ acid\[aq]
47004630\ \ title\-short:\ Molecular\ structure\ of\ nucleic\ acids
47014631\ \ container\-title:\ Nature
47024632\ \ volume:\ 171
@@ -4926,7 +4856,7 @@ Title:\ \ \ My\ title
49264856Author:\ \ John\ Doe
49274857Date:\ \ \ \ September\ 1,\ 2008
49284858Comment:\ This\ is\ a\ sample\ mmd\ title\ block,\ with
4929−\ \ \ \ \ \ \ \ \ a\ field\ spanning\ multiple\ lines.
4859+\ \ \ \ \ a\ field\ spanning\ multiple\ lines.
49304860\f[]
49314861.fi
49324862.PP
@@ -4962,7 +4892,7 @@ extension.
49624892This\ is\ a\ reference\ ![image][ref]\ with\ multimarkdown\ attributes.
49634893
49644894[ref]:\ http://path.to/image\ "Image\ title"\ width=20px\ height=30px
4965−\ \ \ \ \ \ \ id=myId\ class="myClass1\ myClass2"
4895+\ \ \ id=myId\ class="myClass1\ myClass2"
49664896\f[]
49674897.fi
49684898.SS Extension: \f[C]mmd_header_identifiers\f[]
@@ -5495,7 +5425,7 @@ For example:
54955425\f[C]
54965426<audio\ controls="1">
54975427\ \ <source\ src="http://example.com/music/toccata.mp3"
5498−\ \ \ \ \ \ \ \ \ \ data\-external="1"\ type="audio/mpeg">
5428+\ \ \ \ \ \ data\-external="1"\ type="audio/mpeg">
54995429\ \ </source>
55005430</audio>
55015431\f[]