422c0d8 · typeable/pandoc

git.iko.soy/typeable/pandoc

on master help sign in

Update man page.

422c0d8John MacFarlane9 years ago

man/pandoc.1+133−203

compare with master

unifiedsplit

@@ -1,5 +1,5 @@

1.\"t

2−.TH PANDOC 1 "January 7, 2018" "pandoc 2.1"

2+.TH PANDOC 1 "January 7, 2018" "pandoc 2.1.1"

3.SH NAME

4pandoc - general markup converter

5.SH SYNOPSIS

@@ -307,28 +307,16 @@ If this option is not specified, the default user data directory will be

307used.

308This is, in UNIX:

309.RS

310−.IP

310+.PP

311−.nf

312−\f[C]

313$HOME/.pandoc

311$HOME/.pandoc

314−\f[]

315−.fi

316.PP

312.PP

317in Windows XP:

313in Windows XP:

318−.IP

314+.PP

319−.nf

315+C:And SettingsData

320−\f[C]

321−C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\pandoc

322−\f[]

323−.fi

324.PP

316.PP

325and in Windows Vista or later:

317and in Windows Vista or later:

326−.IP

318+.PP

327−.nf

319+C:

328−\f[C]

329−C:\\Users\\USERNAME\\AppData\\Roaming\\pandoc

330−\f[]

331−.fi

332.PP

320.PP

333You can find the default user data directory on your system by looking

321You can find the default user data directory on your system by looking

334at the output of \f[C]pandoc\ \-\-version\f[].

322at the output of \f[C]pandoc\ \-\-version\f[].

@@ -343,12 +331,8 @@ Generate a bash completion script.

343To enable bash completion with pandoc, add this to your

331To enable bash completion with pandoc, add this to your

344\f[C]\&.bashrc\f[]:

332\f[C]\&.bashrc\f[]:

345.RS

333.RS

346−.IP

334+.PP

347−.nf

348−\f[C]

349−\ eval\ "$(pandoc\ \-\-bash\-completion)"

335+eval "$(pandoc \-\-bash\-completion)"

350−\f[]

351−.fi

352.RE

336.RE

353.TP

337.TP

354.B \f[C]\-\-verbose\f[]

338.B \f[C]\-\-verbose\f[]

@@ -462,20 +446,12 @@ The name of the output format will be passed to the filter as the first

462argument.

446argument.

463Hence,

447Hence,

464.RS

448.RS

465−.IP

449+.PP

466−.nf

467−\f[C]

468−pandoc\ \-\-filter\ ./caps.py\ \-t\ latex

450+pandoc \-\-filter ./caps.py \-t latex

469−\f[]

470−.fi

471.PP

451.PP

472is equivalent to

452is equivalent to

473−.IP

453+.PP

474−.nf

475−\f[C]

476−pandoc\ \-t\ json\ |\ ./caps.py\ latex\ |\ pandoc\ \-f\ json\ \-t\ latex

454+pandoc \-t json | ./caps.py latex | pandoc \-f json \-t latex

477−\f[]

478−.fi

479.PP

455.PP

480The latter form may be useful for debugging filters.

456The latter form may be useful for debugging filters.

481.PP

457.PP

@@ -517,20 +493,12 @@ creation.

517It is always loaded into the script\[aq]s lua environment.

493It is always loaded into the script\[aq]s lua environment.

518.PP

494.PP

519The following is an example lua script for macro\-expansion:

495The following is an example lua script for macro\-expansion:

520−.IP

496+.PP

521−.nf

522−\f[C]

523−function\ expand_hello_world(inline)

497+function expand_hello_world(inline) if inline.c ==

524−\ \ if\ inline.c\ ==\ \[aq]{{helloworld}}\[aq]\ then

525−\ \ \ \ return\ pandoc.Emph{\ pandoc.Str\ "Hello,\ World"\ }

498+\[aq]{{helloworld}}\[aq] then return pandoc.Emph{ pandoc.Str "Hello,

526−\ \ else

527−\ \ \ \ return\ inline

499+World" } else return inline end end

528−\ \ end

500+.PP

529−end

530−

531−return\ {{Str\ =\ expand_hello_world}}

501+return {{Str = expand_hello_world}}

532−\f[]

533−.fi

534.RE

502.RE

535.TP

503.TP

536.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[]]

504.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

1010\f[C]\-\-data\-dir\f[]).

978\f[C]\-\-data\-dir\f[]).

1011If this is not found either, sensible defaults will be used.

979If this is not found either, sensible defaults will be used.

1012.RS

980.RS

981+.RE

1013.PP

982.PP

1014To produce a custom \f[C]reference.docx\f[], first get a copy of the

983To produce a custom \f[C]reference.docx\f[], first get a copy of the

1015default \f[C]reference.docx\f[]:

984default \f[C]reference.docx\f[]:

@@ -1025,7 +994,6 @@ Definition Term, Definition, Caption, Table Caption, Image Caption,

1025Figure, Captioned Figure, TOC Heading; [character] Default Paragraph

994Figure, Captioned Figure, TOC Heading; [character] Default Paragraph

1026Font, Body Text Char, Verbatim Char, Footnote Reference, Hyperlink;

995Font, Body Text Char, Verbatim Char, Footnote Reference, Hyperlink;

1027[table] Table.

996[table] Table.

1028−.RE

1029.TP

997.TP

1030.B ODT

998.B ODT

1031For best results, the reference ODT should be a modified version of an

999For 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

1037\f[C]\-\-data\-dir\f[]).

1005\f[C]\-\-data\-dir\f[]).

1038If this is not found either, sensible defaults will be used.

1006If this is not found either, sensible defaults will be used.

1039.RS

1007.RS

1008+.RE

1040.PP

1009.PP

1041To produce a custom \f[C]reference.odt\f[], first get a copy of the

1010To produce a custom \f[C]reference.odt\f[], first get a copy of the

1042default \f[C]reference.odt\f[]:

1011default \f[C]reference.odt\f[]:

@@ -1044,7 +1013,6 @@ default \f[C]reference.odt\f[]:

1044Then open \f[C]custom\-reference.odt\f[] in LibreOffice, modify the

1013Then open \f[C]custom\-reference.odt\f[] in LibreOffice, modify the

1045styles as you wish, and save the file.

1014styles as you wish, and save the file.

1046.RE

1015.RE

1047−.RE

1048.TP

1016.TP

1049.B \f[C]\-\-epub\-cover\-image=\f[]\f[I]FILE\f[]

1017.B \f[C]\-\-epub\-cover\-image=\f[]\f[I]FILE\f[]

1050Use the specified image as the EPUB cover.

1018Use the specified image as the EPUB cover.

@@ -1061,13 +1029,8 @@ Look in the specified XML file for metadata for the EPUB.

1061The file should contain a series of Dublin Core elements.

1029The file should contain a series of Dublin Core elements.

1062For example:

1030For example:

1063.RS

1031.RS

1064−.IP

1032+.PP

1065−.nf

1066−\f[C]

1067−\ <dc:rights>Creative\ Commons</dc:rights>

1033+Creative Commons es\-AR

1068−\ <dc:language>es\-AR</dc:language>

1069−\f[]

1070−.fi

1071.PP

1034.PP

1072By default, pandoc will include the following metadata elements:

1035By default, pandoc will include the following metadata elements:

1073\f[C]<dc:title>\f[] (from the document title), \f[C]<dc:creator>\f[]

1036\f[C]<dc:title>\f[] (from the document title), \f[C]<dc:creator>\f[]

@@ -1092,36 +1055,16 @@ being interpreted by the shell.

1092To use the embedded fonts, you will need to add declarations like the

1055To use the embedded fonts, you will need to add declarations like the

1093following to your CSS (see \f[C]\-\-css\f[]):

1056following to your CSS (see \f[C]\-\-css\f[]):

1094.RS

1057.RS

1095−.IP

1058+.PP

1096−.nf

1097−\f[C]

1098−\@font\-face\ {

1099−font\-family:\ DejaVuSans;

1059+\@font\-face { font\-family: DejaVuSans; font\-style: normal;

1100−font\-style:\ normal;

1101−font\-weight:\ normal;

1102−src:url("DejaVuSans\-Regular.ttf");

1060+font\-weight: normal; src:url("DejaVuSans\-Regular.ttf"); } \@font\-face

1103−}

1104−\@font\-face\ {

1105−font\-family:\ DejaVuSans;

1061+{ font\-family: DejaVuSans; font\-style: normal; font\-weight: bold;

1106−font\-style:\ normal;

1107−font\-weight:\ bold;

1108−src:url("DejaVuSans\-Bold.ttf");

1062+src:url("DejaVuSans\-Bold.ttf"); } \@font\-face { font\-family:

1109−}

1110−\@font\-face\ {

1111−font\-family:\ DejaVuSans;

1112−font\-style:\ italic;

1113−font\-weight:\ normal;

1063+DejaVuSans; font\-style: italic; font\-weight: normal;

1114−src:url("DejaVuSans\-Oblique.ttf");

1064+src:url("DejaVuSans\-Oblique.ttf"); } \@font\-face { font\-family:

1115−}

1116−\@font\-face\ {

1117−font\-family:\ DejaVuSans;

1118−font\-style:\ italic;

1065+DejaVuSans; font\-style: italic; font\-weight: bold;

1119−font\-weight:\ bold;

1120−src:url("DejaVuSans\-BoldOblique.ttf");

1066+src:url("DejaVuSans\-BoldOblique.ttf"); } body { font\-family:

1121−}

1122−body\ {\ font\-family:\ "DejaVuSans";\ }

1067+"DejaVuSans"; }

1123−\f[]

1124−.fi

1125.RE

1068.RE

1126.TP

1069.TP

1127.B \f[C]\-\-epub\-chapter\-level=\f[]\f[I]NUMBER\f[]

1070.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

1306the typeset formulas and an HTML file with links to these images.

1249the typeset formulas and an HTML file with links to these images.

1307So, the procedure is:

1250So, the procedure is:

1308.RS

1251.RS

1309−.IP

1252+.PP

1310−.nf

1311−\f[C]

1312−pandoc\ \-s\ \-\-gladtex\ input.md\ \-o\ myfile.htex

1253+pandoc \-s \-\-gladtex input.md \-o myfile.htex gladtex \-d

1313−gladtex\ \-d\ myfile\-images\ myfile.htex

1314−#\ produces\ myfile.html\ and\ images\ in\ myfile\-images

1254+myfile\-images myfile.htex # produces myfile.html and images in

1315−\f[]

1255+myfile\-images

1316−.fi

1317.RE

1256.RE

1318.TP

1257.TP

1319.B \f[C]\-\-mimetex\f[][\f[C]=\f[]\f[I]URL\f[]]

1258.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).

1346Regular pandoc options are not ignored.

1285Regular pandoc options are not ignored.

1347Thus, for example,

1286Thus, for example,

1348.RS

1287.RS

1349−.IP

1288+.PP

1350−.nf

1351−\f[C]

1352−pandoc\ \-\-ignore\-args\ \-o\ foo.html\ \-s\ foo.txt\ \-\-\ \-e\ latin1

1289+pandoc \-\-ignore\-args \-o foo.html \-s foo.txt \-\- \-e latin1

1353−\f[]

1354−.fi

1355.PP

1290.PP

1356is equivalent to

1291is equivalent to

1357−.IP

1292+.PP

1358−.nf

1359−\f[C]

1360−pandoc\ \-o\ foo.html\ \-s

1293+pandoc \-o foo.html \-s

1361−\f[]

1362−.fi

1363.RE

1294.RE

1364.SH TEMPLATES

1295.SH TEMPLATES

1365.PP

1296.PP

@@ -1413,18 +1344,13 @@ source and destination filenames, as given on the command line.

1413files, or empty if input is from stdin.

1344files, or empty if input is from stdin.

1414You can use the following snippet in your template to distinguish them:

1345You can use the following snippet in your template to distinguish them:

1415.RS

1346.RS

1416−.IP

1347+.PP

1417−.nf

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[])

1418−\f[C]

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[])

1419−$if(sourcefile)$

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[]

1420−$for(sourcefile)$

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[]

1421−$sourcefile$

1352+\f[I]e\f[]\f[I]l\f[]\f[I]s\f[]\f[I]e\f[] (stdin)

1422−$endfor$

1353+\f[I]e\f[]\f[I]n\f[]\f[I]d\f[]\f[I]i\f[]\f[I]f\f[]

1423−$else$

1424−(stdin)

1425−$endif$

1426−\f[]

1427−.fi

1428.PP

1354.PP

1429Similarly, \f[C]outputfile\f[] can be \f[C]\-\f[] if output goes to the

1355Similarly, \f[C]outputfile\f[] can be \f[C]\-\f[] if output goes to the

1430terminal.

1356terminal.

@@ -1436,16 +1362,6 @@ Included in PDF metadata through LaTeX and ConTeXt.

1436These can be set through a pandoc title block, which allows for multiple

1362These can be set through a pandoc title block, which allows for multiple

1437authors, or through a YAML metadata block:

1363authors, or through a YAML metadata block:

1438.RS

1364.RS

1439−.IP

1440−.nf

1441−\f[C]

1442−\-\-\-

1443−author:

1444−\-\ Aristotle

1445−\-\ Peter\ Abelard

1446−\&...

1447−\f[]

1448−.fi

1449.RE

1365.RE

1450.TP

1366.TP

1451.B \f[C]subtitle\f[]

1367.B \f[C]subtitle\f[]

@@ -1487,7 +1403,7 @@ specified

1487.TP

1403.TP

1488.B \f[C]toc\-title\f[]

1404.B \f[C]toc\-title\f[]

1489title of table of contents (works only with EPUB, opendocument, odt,

1405title of table of contents (works only with EPUB, opendocument, odt,

1490−docx)

1406+docx, pptx)

1491.RS

1407.RS

1492.RE

1408.RE

1493.TP

1409.TP

@@ -1524,23 +1440,12 @@ stored in the additional variables \f[C]babel\-lang\f[],

1524\f[C]polyglossia\-lang\f[] (LaTeX) and \f[C]context\-lang\f[] (ConTeXt).

1440\f[C]polyglossia\-lang\f[] (LaTeX) and \f[C]context\-lang\f[] (ConTeXt).

1525.RS

1441.RS

1526.PP

1442.PP

1527−Native pandoc \f[C]span\f[]s and \f[C]div\f[]s with the lang attribute

1443+Native pandoc Spans and Divs with the lang attribute (value in BCP 47)

1528−(value in BCP 47) can be used to switch the language in that range.

1444+can be used to switch the language in that range.

1529−.RE

1445+In LaTeX output, \f[C]babel\-otherlangs\f[] and

1530−.TP

1446+\f[C]polyglossia\-otherlangs\f[] variables will be generated

1531−.B \f[C]otherlangs\f[]

1447+automatically based on the \f[C]lang\f[] attributes of Spans and Divs in

1532−a list of other languages used in the document in the YAML metadata,

1448+the document.

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

1544.RE

1449.RE

1545.TP

1450.TP

1546.B \f[C]dir\f[]

1451.B \f[C]dir\f[]

@@ -2360,6 +2265,12 @@ to Emacs Muse markup.

2360.PP

2265.PP

2361Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted

2266Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted

2362in \f[C]org\f[] input.

2267in \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.

2363.SH PANDOC\[aq]S MARKDOWN

2274.SH PANDOC\[aq]S MARKDOWN

2364.PP

2275.PP

2365Pandoc understands an extended and slightly revised version of John

2276Pandoc understands an extended and slightly revised version of John

@@ -2677,9 +2588,9 @@ For example,

2677.IP

2588.IP

2678.nf

2589.nf

2679\f[C]

2590\f[C]

2680−\ \ \ \ if\ (a\ >\ 3)\ {

2591+if\ (a\ >\ 3)\ {

2681−\ \ \ \ \ \ moveShip(5\ *\ gravity,\ DOWN);

2592+\ \ moveShip(5\ *\ gravity,\ DOWN);

2682−\ \ \ \ }

2593+}

2683\f[]

2594\f[]

2684.fi

2595.fi

2685.PP

2596.PP

@@ -2736,7 +2647,7 @@ using this syntax:

2736~~~~\ {#mycode\ .haskell\ .numberLines\ startFrom="100"}

2647~~~~\ {#mycode\ .haskell\ .numberLines\ startFrom="100"}

2737qsort\ []\ \ \ \ \ =\ []

2648qsort\ []\ \ \ \ \ =\ []

2738qsort\ (x:xs)\ =\ qsort\ (filter\ (<\ x)\ xs)\ ++\ [x]\ ++

2649qsort\ (x:xs)\ =\ qsort\ (filter\ (<\ x)\ xs)\ ++\ [x]\ ++

2739−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ qsort\ (filter\ (>=\ x)\ xs)

2650+\ \ \ \ \ \ \ qsort\ (filter\ (>=\ x)\ xs)

2740~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

2651~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

2741\f[]

2652\f[]

2742.fi

2653.fi

@@ -2898,12 +2809,12 @@ marker.

2898\f[C]

2809\f[C]

2899\ \ *\ First\ paragraph.

2810\ \ *\ First\ paragraph.

2900

2811

2901−\ \ \ \ Continued.

2812+Continued.

2902

2813

2903\ \ *\ Second\ paragraph.\ With\ a\ code\ block,\ which\ must\ be\ indented

2814\ \ *\ Second\ paragraph.\ With\ a\ code\ block,\ which\ must\ be\ indented

2904−\ \ \ \ eight\ spaces:

2815+eight\ spaces:

2905

2816

2906−\ \ \ \ \ \ \ \ {\ code\ }

2817+\ \ \ \ {\ code\ }

2907\f[]

2818\f[]

2908.fi

2819.fi

2909.PP

2820.PP

@@ -2929,8 +2840,8 @@ character after the list marker of the containing list item.

2929\f[C]

2840\f[C]

2930*\ fruits

2841*\ fruits

2931\ \ +\ apples

2842\ \ +\ apples

2932−\ \ \ \ \-\ macintosh

2843+\-\ macintosh

2933−\ \ \ \ \-\ red\ delicious

2844+\-\ red\ delicious

2934\ \ +\ pears

2845\ \ +\ pears

2935\ \ +\ peaches

2846\ \ +\ peaches

2936*\ vegetables

2847*\ vegetables

@@ -2952,7 +2863,7 @@ item.

2952+\ Another\ one;\ this\ looks

2863+\ Another\ one;\ this\ looks

2953bad\ but\ is\ legal.

2864bad\ but\ is\ legal.

2954

2865

2955−\ \ \ \ Second\ paragraph\ of\ second

2866+Second\ paragraph\ of\ second

2956list\ item.

2867list\ item.

2957\f[]

2868\f[]

2958.fi

2869.fi

@@ -3017,9 +2928,9 @@ numerals:

3017\ 9)\ \ Ninth

2928\ 9)\ \ Ninth

301810)\ \ Tenth

292910)\ \ Tenth

301911)\ \ Eleventh

293011)\ \ Eleventh

3020−\ \ \ \ \ \ \ i.\ subone

2931+\ \ \ i.\ subone

3021−\ \ \ \ \ \ ii.\ subtwo

2932+\ \ ii.\ subtwo

3022−\ \ \ \ \ iii.\ subthree

2933+\ iii.\ subthree

3023\f[]

2934\f[]

3024.fi

2935.fi

3025.PP

2936.PP

@@ -3061,9 +2972,9 @@ Term\ 2\ with\ *inline\ markup*

3061

2972

3062:\ \ \ Definition\ 2

2973:\ \ \ Definition\ 2

3063

2974

3064−\ \ \ \ \ \ \ \ {\ some\ code,\ part\ of\ Definition\ 2\ }

2975+\ \ \ \ {\ some\ code,\ part\ of\ Definition\ 2\ }

3065

2976

3066−\ \ \ \ Third\ paragraph\ of\ definition\ 2.

2977+Third\ paragraph\ of\ definition\ 2.

3067\f[]

2978\f[]

3068.fi

2979.fi

3069.PP

2980.PP

@@ -3087,7 +2998,7 @@ Term\ 1

3087:\ \ \ Definition

2998:\ \ \ Definition

3088with\ lazy\ continuation.

2999with\ lazy\ continuation.

3089

3000

3090−\ \ \ \ Second\ paragraph\ of\ the\ definition.

3001+Second\ paragraph\ of\ the\ definition.

3091\f[]

3002\f[]

3092.fi

3003.fi

3093.PP

3004.PP

@@ -3165,9 +3076,9 @@ Consider this source:

3165\f[C]

3076\f[C]

3166+\ \ \ First

3077+\ \ \ First

3167+\ \ \ Second:

3078+\ \ \ Second:

3168−\ \ \ \ \-\ \ \ Fee

3079+\-\ \ \ Fee

3169−\ \ \ \ \-\ \ \ Fie

3080+\-\ \ \ Fie

3170−\ \ \ \ \-\ \ \ Foe

3081+\-\ \ \ Foe

3171

3082

3172+\ \ \ Third

3083+\ \ \ Third

3173\f[]

3084\f[]

@@ -3196,7 +3107,7 @@ What if you want to put an indented code block after a list?

3196\-\ \ \ item\ one

3107\-\ \ \ item\ one

3197\-\ \ \ item\ two

3108\-\ \ \ item\ two

3198

3109

3199−\ \ \ \ {\ my\ code\ block\ }

3110+{\ my\ code\ block\ }

3200\f[]

3111\f[]

3201.fi

3112.fi

3202.PP

3113.PP

@@ -3215,7 +3126,7 @@ any format:

3215

3126

3216<!\-\-\ end\ of\ list\ \-\->

3127<!\-\-\ end\ of\ list\ \-\->

3217

3128

3218−\ \ \ \ {\ my\ code\ block\ }

3129+{\ my\ code\ block\ }

3219\f[]

3130\f[]

3220.fi

3131.fi

3221.PP

3132.PP

@@ -3270,9 +3181,9 @@ Simple tables look like this:

3270\f[C]

3181\f[C]

3271\ \ Right\ \ \ \ \ Left\ \ \ \ \ Center\ \ \ \ \ Default

3182\ \ Right\ \ \ \ \ Left\ \ \ \ \ Center\ \ \ \ \ Default

3272\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3183\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3273−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ 12

3184+\ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ 12

3274−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ 123

3185+123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ 123

3275−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ 1

3186+\ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ 1

3276

3187

3277Table:\ \ Demonstration\ of\ simple\ table\ syntax.

3188Table:\ \ Demonstration\ of\ simple\ table\ syntax.

3278\f[]

3189\f[]

@@ -3304,9 +3215,9 @@ For example:

3304.nf

3215.nf

3305\f[C]

3216\f[C]

3306\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3217\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3307−\ \ \ \ \ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ \ 12

3218+\ 12\ \ \ \ \ 12\ \ \ \ \ \ \ \ 12\ \ \ \ \ \ \ \ \ \ \ \ \ 12

3308−\ \ \ \ 123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ \ 123

3219+123\ \ \ \ \ 123\ \ \ \ \ \ \ 123\ \ \ \ \ \ \ \ \ \ \ 123

3309−\ \ \ \ \ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ \ 1

3220+\ \ 1\ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ 1\ \ \ \ \ \ \ \ \ \ \ \ \ \ 1

3310\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3221\-\-\-\-\-\-\-\ \ \ \ \ \-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\ \ \ \-\-\-\-\-\-\-

3311\f[]

3222\f[]

3312.fi

3223.fi

@@ -3329,11 +3240,11 @@ Here is an example:

3329\ \ Header\ \ \ \ Aligned\ \ \ \ \ \ \ \ \ Aligned\ Aligned

3240\ \ Header\ \ \ \ Aligned\ \ \ \ \ \ \ \ \ Aligned\ Aligned

3330\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3241\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3331\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that

3242\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that

3332−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.

3243+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.

3333

3244

3334\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note

3245\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note

3335−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between

3246+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between

3336−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.

3247+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.

3337\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3248\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3338

3249

3339Table:\ Here\[aq]s\ the\ caption.\ It,\ too,\ may\ span

3250Table:\ 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:

3362\f[C]

3273\f[C]

3363\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3274\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3364\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that

3275\ \ \ First\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 12.0\ Example\ of\ a\ row\ that

3365−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.

3276+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ spans\ multiple\ lines.

3366

3277

3367\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note

3278\ \ Second\ \ \ \ row\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 5.0\ Here\[aq]s\ another\ one.\ Note

3368−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between

3279+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ the\ blank\ line\ between

3369−\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.

3280+\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ rows.

3370\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3281\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\ \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

3371

3282

3372:\ Here\[aq]s\ a\ multiline\ table\ without\ headers.

3283:\ Here\[aq]s\ a\ multiline\ table\ without\ headers.

@@ -3714,6 +3625,23 @@ $endif$

3714$endfor$

3625$endfor$

3715\f[]

3626\f[]

3716.fi

3627.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

3717.SS Backslash escapes

3645.SS Backslash escapes

3718.SS Extension: \f[C]all_symbols_escapable\f[]

3646.SS Extension: \f[C]all_symbols_escapable\f[]

3719.PP

3647.PP

@@ -4157,13 +4085,15 @@ $\\tuple{a,\ b,\ c}$

4157\f[]

4085\f[]

4158.fi

4086.fi

4159.PP

4087.PP

4160−In LaTeX output, the macro definitions will not be passed through as raw

4088+Note that LaTeX macros will not be applied if they occur inside inside a

4161−LaTeX.

4089+raw span or block marked with the \f[C]raw_attribute\f[] extension.

4162.PP

4090.PP

4163−When \f[C]latex_macros\f[] is disabled, the macro definitions will be

4091+When \f[C]latex_macros\f[] is disabled, the raw LaTeX and math will not

4164−passed through as raw LaTeX, and the raw LaTeX and math will not have

4165−macros applied.

4092+have macros applied.

4166This is usually a better approach when you are targeting LaTeX or PDF.

4093This 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.

4167.SS Links

4097.SS Links

4168.PP

4098.PP

4169Markdown allows links to be specified in several ways.

4099Markdown 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:

4359.IP

4289.IP

4360.nf

4290.nf

4361\f[C]

4291\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)\\

4363\f[]

4293\f[]

4364.fi

4294.fi

4365.PP

4295.PP

@@ -4501,14 +4431,14 @@ Here\ is\ a\ footnote\ reference,[^1]\ and\ another.[^longnote]

4501

4431

4502[^longnote]:\ Here\[aq]s\ one\ with\ multiple\ blocks.

4432[^longnote]:\ Here\[aq]s\ one\ with\ multiple\ blocks.

4503

4433

4504−\ \ \ \ Subsequent\ paragraphs\ are\ indented\ to\ show\ that\ they

4434+Subsequent\ paragraphs\ are\ indented\ to\ show\ that\ they

4505belong\ to\ the\ previous\ footnote.

4435belong\ to\ the\ previous\ footnote.

4506

4436

4507−\ \ \ \ \ \ \ \ {\ some.code\ }

4437+\ \ \ \ {\ some.code\ }

4508

4438

4509−\ \ \ \ The\ whole\ paragraph\ can\ be\ indented,\ or\ just\ the\ first

4439+The\ whole\ paragraph\ can\ be\ indented,\ or\ just\ the\ first

4510−\ \ \ \ line.\ \ In\ this\ way,\ multi\-paragraph\ footnotes\ work\ like

4440+line.\ \ In\ this\ way,\ multi\-paragraph\ footnotes\ work\ like

4511−\ \ \ \ multi\-paragraph\ list\ items.

4441+multi\-paragraph\ list\ items.

4512

4442

4513This\ paragraph\ won\[aq]t\ be\ part\ of\ the\ note,\ because\ it

4443This\ paragraph\ won\[aq]t\ be\ part\ of\ the\ note,\ because\ it

4514isn\[aq]t\ indented.

4444isn\[aq]t\ indented.

@@ -4687,16 +4617,16 @@ references:

4687\ \ id:\ WatsonCrick1953

4617\ \ id:\ WatsonCrick1953

4688\ \ author:

4618\ \ author:

4689\ \ \-\ family:\ Watson

4619\ \ \-\ family:\ Watson

4690−\ \ \ \ given:\ J.\ D.

4620+given:\ J.\ D.

4691\ \ \-\ family:\ Crick

4621\ \ \-\ family:\ Crick

4692−\ \ \ \ given:\ F.\ H.\ C.

4622+given:\ F.\ H.\ C.

4693\ \ issued:

4623\ \ issued:

4694−\ \ \ \ date\-parts:

4624+date\-parts:

4695−\ \ \ \ \-\ \-\ 1953

4625+\-\ \-\ 1953

4696−\ \ \ \ \ \ \-\ 4

4626+\ \ \-\ 4

4697−\ \ \ \ \ \ \-\ 25

4627+\ \ \-\ 25

4698\ \ title:\ \[aq]Molecular\ structure\ of\ nucleic\ acids:\ a\ structure\ for\ deoxyribose

4628\ \ title:\ \[aq]Molecular\ structure\ of\ nucleic\ acids:\ a\ structure\ for\ deoxyribose

4699−\ \ \ \ nucleic\ acid\[aq]

4629+nucleic\ acid\[aq]

4700\ \ title\-short:\ Molecular\ structure\ of\ nucleic\ acids

4630\ \ title\-short:\ Molecular\ structure\ of\ nucleic\ acids

4701\ \ container\-title:\ Nature

4631\ \ container\-title:\ Nature

4702\ \ volume:\ 171

4632\ \ volume:\ 171

@@ -4926,7 +4856,7 @@ Title:\ \ \ My\ title

4926Author:\ \ John\ Doe

4856Author:\ \ John\ Doe

4927Date:\ \ \ \ September\ 1,\ 2008

4857Date:\ \ \ \ September\ 1,\ 2008

4928Comment:\ This\ is\ a\ sample\ mmd\ title\ block,\ with

4858Comment:\ This\ is\ a\ sample\ mmd\ title\ block,\ with

4929−\ \ \ \ \ \ \ \ \ a\ field\ spanning\ multiple\ lines.

4859+\ \ \ \ \ a\ field\ spanning\ multiple\ lines.

4930\f[]

4860\f[]

4931.fi

4861.fi

4932.PP

4862.PP

@@ -4962,7 +4892,7 @@ extension.

4962This\ is\ a\ reference\ ![image][ref]\ with\ multimarkdown\ attributes.

4892This\ is\ a\ reference\ ![image][ref]\ with\ multimarkdown\ attributes.

4963

4893

4964[ref]:\ http://path.to/image\ "Image\ title"\ width=20px\ height=30px

4894[ref]:\ http://path.to/image\ "Image\ title"\ width=20px\ height=30px

4965−\ \ \ \ \ \ \ id=myId\ class="myClass1\ myClass2"

4895+\ \ \ id=myId\ class="myClass1\ myClass2"

4966\f[]

4896\f[]

4967.fi

4897.fi

4968.SS Extension: \f[C]mmd_header_identifiers\f[]

4898.SS Extension: \f[C]mmd_header_identifiers\f[]

@@ -5495,7 +5425,7 @@ For example:

5495\f[C]

5425\f[C]

5496<audio\ controls="1">

5426<audio\ controls="1">

5497\ \ <source\ src="http://example.com/music/toccata.mp3"

5427\ \ <source\ src="http://example.com/music/toccata.mp3"

5498−\ \ \ \ \ \ \ \ \ \ data\-external="1"\ type="audio/mpeg">

5428+\ \ \ \ \ \ data\-external="1"\ type="audio/mpeg">

5499\ \ </source>

5429\ \ </source>

5500</audio>

5430</audio>

5501\f[]

5431\f[]