@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "March 12, 2019" "pandoc 2.7.1"
2+.TH PANDOC 1 "April 5, 2019" "pandoc 2.7.2"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -393,6 +393,8 @@ HTML5/XHTML polyglot markup)
393393.IP \[bu] 2
394394\f[C]tei\f[R] (TEI Simple)
395395.IP \[bu] 2
396+\f[C]xwiki\f[R] (XWiki markup)
397+.IP \[bu] 2
396398\f[C]zimwiki\f[R] (ZimWiki markup)
397399.IP \[bu] 2
398400the path of a custom lua writer, see Custom writers below
@@ -488,7 +490,7 @@ Show usage message.
488490.SS Reader options
489491.TP
490492.B \f[C]--base-header-level=\f[R]\f[I]NUMBER\f[R]
491−Specify the base level for headers (defaults to 1).
493+Specify the base level for headings (defaults to 1).
492494.TP
493495.B \f[C]--strip-empty-paragraphs\f[R]
494496\f[I]Deprecated. Use the \f[CI]+empty_paragraphs\f[I] extension
@@ -767,7 +769,7 @@ it has no effect on \f[C]man\f[R], \f[C]docbook4\f[R],
767769.B \f[C]--toc-depth=\f[R]\f[I]NUMBER\f[R]
768770Specify the number of section levels to include in the table of
769771contents.
770−The default is 3 (which means that level 1, 2, and 3 headers will be
772+The default is 3 (which means that level-1, 2, and 3 headings will be
771773listed in the contents).
772774.TP
773775.B \f[C]--strip-comments\f[R]
@@ -919,17 +921,17 @@ The default is \f[C]document\f[R].
919921Currently only affects the markdown writer.
920922.TP
921923.B \f[C]--atx-headers\f[R]
922−Use ATX-style headers in Markdown output.
923−The default is to use setext-style headers for levels 1-2, and then ATX
924−headers.
925−(Note: for \f[C]gfm\f[R] output, ATX headers are always used.) This
924+Use ATX-style headings in Markdown output.
925+The default is to use setext-style headings for levels 1 to 2, and then
926+ATX headings.
927+(Note: for \f[C]gfm\f[R] output, ATX headings are always used.) This
926928option also affects markdown cells in \f[C]ipynb\f[R] output.
927929.TP
928930.B \f[C]--top-level-division=[default|section|chapter|part]\f[R]
929−Treat top-level headers as the given division type in LaTeX, ConTeXt,
931+Treat top-level headings as the given division type in LaTeX, ConTeXt,
930932DocBook, and TEI output.
931−The hierarchy order is part, chapter, then section; all headers are
932−shifted such that the top-level header becomes the specified type.
933+The hierarchy order is part, chapter, then section; all headings are
934+shifted such that the top-level heading becomes the specified type.
933935The default behavior is to determine the best division type via
934936heuristics: unless other conditions apply, \f[C]section\f[R] is chosen.
935937When the LaTeX document class is set to \f[C]report\f[R],
@@ -937,8 +939,8 @@ When the LaTeX document class is set to \f[C]report\f[R],
937939is specified), \f[C]chapter\f[R] is implied as the setting for this
938940option.
939941If \f[C]beamer\f[R] is the output format, specifying either
940−\f[C]chapter\f[R] or \f[C]part\f[R] will cause top-level headers to
941−become \f[C]\[rs]part{..}\f[R], while second-level headers remain as
942+\f[C]chapter\f[R] or \f[C]part\f[R] will cause top-level headings to
943+become \f[C]\[rs]part{..}\f[R], while second-level headings remain as
942944their default type.
943945.TP
944946.B \f[C]-N\f[R], \f[C]--number-sections\f[R]
@@ -950,11 +952,12 @@ Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
950952.B \f[C]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[C],\f[R]\f[I]NUMBER\f[R]\f[C],\f[R]\f[I]...\f[R]]
951953Offset for section headings in HTML output (ignored in other output
952954formats).
953−The first number is added to the section number for top-level headers,
954−the second for second-level headers, and so on.
955−So, for example, if you want the first top-level header in your document
956−to be numbered \[dq]6\[dq], specify \f[C]--number-offset=5\f[R].
957−If your document starts with a level-2 header which you want to be
955+The first number is added to the section number for top-level headings,
956+the second for second-level headings, and so on.
957+So, for example, if you want the first top-level heading in your
958+document to be numbered \[dq]6\[dq], specify
959+\f[C]--number-offset=5\f[R].
960+If your document starts with a level-2 heading which you want to be
958961numbered \[dq]1.5\[dq], specify \f[C]--number-offset=1,4\f[R].
959962Offsets are 0 by default.
960963Implies \f[C]--number-sections\f[R].
@@ -971,13 +974,13 @@ Make list items in slide shows display incrementally (one by one).
971974The default is for lists to be displayed all at once.
972975.TP
973976.B \f[C]--slide-level=\f[R]\f[I]NUMBER\f[R]
974−Specifies that headers with the specified level create slides (for
977+Specifies that headings with the specified level create slides (for
975978\f[C]beamer\f[R], \f[C]s5\f[R], \f[C]slidy\f[R], \f[C]slideous\f[R],
976979\f[C]dzslides\f[R]).
977−Headers above this level in the hierarchy are used to divide the slide
978−show into sections; headers below this level create subheads within a
980+Headings above this level in the hierarchy are used to divide the slide
981+show into sections; headings below this level create subheads within a
979982slide.
980−Note that content that is not contained under slide-level headers will
983+Note that content that is not contained under slide-level headings will
981984not appear in the slide show.
982985The default is to set the slide level based on the contents of the
983986document; see Structuring the slide show.
@@ -985,8 +988,8 @@ document; see Structuring the slide show.
985988.B \f[C]--section-divs\f[R]
986989Wrap sections in \f[C]<section>\f[R] tags (or \f[C]<div>\f[R] tags for
987990\f[C]html4\f[R]), and attach identifiers to the enclosing
988−\f[C]<section>\f[R] (or \f[C]<div>\f[R]) rather than the header itself.
989−See Header identifiers, below.
991+\f[C]<section>\f[R] (or \f[C]<div>\f[R]) rather than the heading itself.
992+See Heading identifiers, below.
990993.TP
991994.B \f[C]--email-obfuscation=none\f[R]|\f[C]javascript\f[R]|\f[C]references\f[R]
992995Specify a method for obfuscating \f[C]mailto:\f[R] links in HTML
@@ -1145,13 +1148,13 @@ styles as you wish, and save the file.
11451148.RE
11461149.TP
11471150.B PowerPoint
1148−Any template included with a recent install of Microsoft PowerPoint
1149−(either with \f[C].pptx\f[R] or \f[C].potx\f[R] extension) should work,
1150−as will most templates derived from these.
1151+Templates included with Microsoft PowerPoint 2013 (either with
1152+\f[C].pptx\f[R] or \f[C].potx\f[R] extension) are known to work, as are
1153+most templates derived from these.
11511154.RS
11521155.PP
1153−The specific requirement is that the template should contain the
1154−following four layouts as its first four layouts:
1156+The specific requirement is that the template should begin with the
1157+following first four layouts:
11551158.IP "1." 3
11561159Title Slide
11571160.IP "2." 3
@@ -1251,13 +1254,13 @@ body { font-family: \[dq]DejaVuSans\[dq]; }
12511254.RE
12521255.TP
12531256.B \f[C]--epub-chapter-level=\f[R]\f[I]NUMBER\f[R]
1254−Specify the header level at which to split the EPUB into separate
1257+Specify the heading level at which to split the EPUB into separate
12551258\[dq]chapter\[dq] files.
1256−The default is to split into chapters at level 1 headers.
1259+The default is to split into chapters at level-1 headings.
12571260This option only affects the internal composition of the EPUB, not the
12581261way chapters and sections are displayed to users.
12591262Some readers may be slow if the chapter files are too large, so for
1260−large documents with few level 1 headers, one might want to use a
1263+large documents with few level-1 headings, one might want to use a
12611264chapter level of 2 or 3.
12621265.TP
12631266.B \f[C]--epub-subdirectory=\f[R]\f[I]DIRNAME\f[R]
@@ -1646,19 +1649,73 @@ image for title slide
16461649Pandoc uses these variables when creating a PDF with a LaTeX engine.
16471650.SS Layout
16481651.TP
1652+.B \f[C]block-headings\f[R]
1653+make \f[C]\[rs]paragraph\f[R] and \f[C]\[rs]subparagraph\f[R] (fourth-
1654+and fifth-level headings, or fifth- and sixth-level with book classes)
1655+free-standing rather than run-in; requires further formatting to
1656+distinguish from \f[C]\[rs]subsubsection\f[R] (third- or fourth-level
1657+headings).
1658+Instead of using this option, KOMA-Script can adjust headings more
1659+extensively:
1660+.RS
1661+.IP
1662+.nf
1663+\f[C]
1664+---
1665+documentclass: scrartcl
1666+header-includes: |
1667+ \[rs]RedeclareSectionCommand[
1668+ beforeskip=-10pt plus -2pt minus -1pt,
1669+ afterskip=1sp plus -1sp minus 1sp,
1670+ font=\[rs]normalfont\[rs]itshape]{paragraph}
1671+ \[rs]RedeclareSectionCommand[
1672+ beforeskip=-10pt plus -2pt minus -1pt,
1673+ afterskip=1sp plus -1sp minus 1sp,
1674+ font=\[rs]normalfont\[rs]scshape,
1675+ indent=0pt]{subparagraph}
1676+\&...
1677+\f[R]
1678+.fi
1679+.RE
1680+.TP
16491681.B \f[C]classoption\f[R]
16501682option for document class, e.g.
1651−\f[C]oneside\f[R]; repeat for multiple options
1683+\f[C]oneside\f[R]; repeat for multiple options:
1684+.RS
1685+.IP
1686+.nf
1687+\f[C]
1688+---
1689+classoption:
1690+- twocolumn
1691+- landscape
1692+\&...
1693+\f[R]
1694+.fi
1695+.RE
16521696.TP
16531697.B \f[C]documentclass\f[R]
16541698document class: usually one of the standard classes, \f[C]article\f[R],
1655−\f[C]report\f[R], and \f[C]book\f[R]; the KOMA-Script equivalents,
1656−\f[C]scrartcl\f[R], \f[C]scrreprt\f[R], and \f[C]scrbook\f[R], which
1699+\f[C]book\f[R], and \f[C]report\f[R]; the KOMA-Script equivalents,
1700+\f[C]scrartcl\f[R], \f[C]scrbook\f[R], and \f[C]scrreprt\f[R], which
16571701default to smaller margins; or \f[C]memoir\f[R]
16581702.TP
16591703.B \f[C]geometry\f[R]
16601704option for \f[C]geometry\f[R] package, e.g.
1661−\f[C]margin=1in\f[R]; repeat for multiple options
1705+\f[C]margin=1in\f[R]; repeat for multiple options:
1706+.RS
1707+.IP
1708+.nf
1709+\f[C]
1710+---
1711+geometry:
1712+- top=30mm
1713+- left=20mm
1714+- heightrounded
1715+\&...
1716+\f[R]
1717+.fi
1718+.RE
16621719.TP
16631720.B \f[C]indent\f[R]
16641721uses document class settings for indentation (the default LaTeX template
@@ -1684,11 +1741,6 @@ paper size, e.g.
16841741.B \f[C]secnumdepth\f[R]
16851742numbering depth for sections (with \f[C]--number-sections\f[R] option or
16861743\f[C]numbersections\f[R] variable)
1687−.TP
1688−.B \f[C]subparagraph\f[R]
1689−disables default behavior of LaTeX template that redefines
1690−(sub)paragraphs as sections, changing the appearance of nested headings
1691−in some classes
16921744.SS Fonts
16931745.TP
16941746.B \f[C]fontenc\f[R]
@@ -2145,11 +2197,11 @@ these characters literally.
21452197In writing LaTeX, enabling \f[C]smart\f[R] tells pandoc to use the
21462198ligatures when possible; if \f[C]smart\f[R] is disabled pandoc will use
21472199unicode quotation mark and dash characters.
2148−.SS Headers and sections
2200+.SS Headings and sections
21492201.SS Extension: \f[C]auto_identifiers\f[R]
21502202.PP
2151−A header without an explicitly specified identifier will be
2152−automatically assigned a unique identifier based on the header text.
2203+A heading without an explicitly specified identifier will be
2204+automatically assigned a unique identifier based on the heading text.
21532205.PP
21542206This extension can be enabled/disabled for the following formats:
21552207.TP
@@ -2163,8 +2215,8 @@ This extension can be enabled/disabled for the following formats:
21632215.B enabled by default in
21642216\f[C]markdown\f[R], \f[C]muse\f[R]
21652217.PP
2166−The default algorithm used to derive the identifier from the header text
2167−is:
2218+The default algorithm used to derive the identifier from the heading
2219+text is:
21682220.IP \[bu] 2
21692221Remove all formatting, links, etc.
21702222.IP \[bu] 2
@@ -2188,15 +2240,15 @@ Thus, for example,
21882240tab(@);
21892241l l.
21902242T{
2191−Header
2243+Heading
21922244T}@T{
21932245Identifier
21942246T}
21952247_
21962248T{
2197−\f[C]Header identifiers in HTML\f[R]
2249+\f[C]Heading identifiers in HTML\f[R]
21982250T}@T{
2199−\f[C]header-identifiers-in-html\f[R]
2251+\f[C]heading-identifiers-in-html\f[R]
22002252T}
22012253T{
22022254\f[C]Ma\[^i]tre d\[aq]h\[^o]tel\f[R]
@@ -2226,8 +2278,8 @@ T}
22262278.TE
22272279.PP
22282280These rules should, in most cases, allow one to determine the identifier
2229−from the header text.
2230−The exception is when several headers have the same text; in this case,
2281+from the heading text.
2282+The exception is when several headings have the same text; in this case,
22312283the first will get an identifier as described above; the second will get
22322284the same identifier with \f[C]-1\f[R] appended; the third with
22332285\f[C]-2\f[R]; and so on.
@@ -2244,7 +2296,7 @@ A link to this section, for example, might look like this:
22442296.nf
22452297\f[C]
22462298See the section on
2247−[header identifiers](#header-identifiers-in-html-latex-and-context).
2299+[heading identifiers](#heading-identifiers-in-html-latex-and-context).
22482300\f[R]
22492301.fi
22502302.PP
@@ -2255,7 +2307,7 @@ If the \f[C]--section-divs\f[R] option is specified, then each section
22552307will be wrapped in a \f[C]section\f[R] (or a \f[C]div\f[R], if
22562308\f[C]html4\f[R] was specified), and the identifier will be attached to
22572309the enclosing \f[C]<section>\f[R] (or \f[C]<div>\f[R]) tag rather than
2258−the header itself.
2310+the heading itself.
22592311This allows entire sections to be manipulated using JavaScript or
22602312treated differently in CSS.
22612313.SS Extension: \f[C]ascii_identifiers\f[R]
@@ -2354,14 +2406,14 @@ In Markdown input, \[dq]bird track\[dq] sections will be parsed as
23542406Haskell code rather than block quotations.
23552407Text between \f[C]\[rs]begin{code}\f[R] and \f[C]\[rs]end{code}\f[R]
23562408will also be treated as Haskell code.
2357−For ATX-style headers the character \[aq]=\[aq] will be used instead of
2409+For ATX-style headings the character \[aq]=\[aq] will be used instead of
23582410\[aq]#\[aq].
23592411.IP \[bu] 2
23602412In Markdown output, code blocks with classes \f[C]haskell\f[R] and
23612413\f[C]literate\f[R] will be rendered using bird tracks, and block
23622414quotations will be indented one space, so they will not be treated as
23632415Haskell code.
2364−In addition, headers will be rendered setext-style (with underlines)
2416+In addition, headings will be rendered setext-style (with underlines)
23652417rather than ATX-style (with \[aq]#\[aq] characters).
23662418(This is because ghc treats \[aq]#\[aq] characters in column 1 as
23672419introducing line numbers.)
@@ -2490,52 +2542,52 @@ line.
24902542A backslash followed by a newline is also a hard line break.
24912543Note: in multiline and grid table cells, this is the only way to create
24922544a hard line break, since trailing spaces in the cells are ignored.
2493−.SS Headers
2545+.SS Headings
24942546.PP
2495−There are two kinds of headers: Setext and ATX.
2496−.SS Setext-style headers
2547+There are two kinds of headings: Setext and ATX.
2548+.SS Setext-style headings
24972549.PP
2498−A setext-style header is a line of text \[dq]underlined\[dq] with a row
2499−of \f[C]=\f[R] signs (for a level one header) or \f[C]-\f[R] signs (for
2500−a level two header):
2550+A setext-style heading is a line of text \[dq]underlined\[dq] with a row
2551+of \f[C]=\f[R] signs (for a level-one heading) or \f[C]-\f[R] signs (for
2552+a level-two heading):
25012553.IP
25022554.nf
25032555\f[C]
2504−A level-one header
2505−==================
2556+A level-one heading
2557+===================
25062558
2507−A level-two header
2508−------------------
2559+A level-two heading
2560+-------------------
25092561\f[R]
25102562.fi
25112563.PP
2512−The header text can contain inline formatting, such as emphasis (see
2564+The heading text can contain inline formatting, such as emphasis (see
25132565Inline formatting, below).
2514−.SS ATX-style headers
2566+.SS ATX-style headings
25152567.PP
2516−An ATX-style header consists of one to six \f[C]#\f[R] signs and a line
2568+An ATX-style heading consists of one to six \f[C]#\f[R] signs and a line
25172569of text, optionally followed by any number of \f[C]#\f[R] signs.
25182570The number of \f[C]#\f[R] signs at the beginning of the line is the
2519−header level:
2571+heading level:
25202572.IP
25212573.nf
25222574\f[C]
2523−## A level-two header
2575+## A level-two heading
25242576
2525−### A level-three header ###
2577+### A level-three heading ###
25262578\f[R]
25272579.fi
25282580.PP
2529−As with setext-style headers, the header text can contain formatting:
2581+As with setext-style headings, the heading text can contain formatting:
25302582.IP
25312583.nf
25322584\f[C]
2533−# A level-one header with a [link](/url) and *emphasis*
2585+# A level-one heading with a [link](/url) and *emphasis*
25342586\f[R]
25352587.fi
25362588.SS Extension: \f[C]blank_before_header\f[R]
25372589.PP
2538−Standard Markdown syntax does not require a blank line before a header.
2590+Standard Markdown syntax does not require a blank line before a heading.
25392591Pandoc does require this (except, of course, at the beginning of the
25402592document).
25412593The reason for the requirement is that it is all too easy for a
@@ -2552,16 +2604,16 @@ I like several of their flavors of ice cream:
25522604.SS Extension: \f[C]space_in_atx_header\f[R]
25532605.PP
25542606Many Markdown implementations do not require a space between the opening
2555−\f[C]#\f[R]s of an ATX header and the header text, so that
2556−\f[C]#5 bolt\f[R] and \f[C]#hashtag\f[R] count as headers.
2607+\f[C]#\f[R]s of an ATX heading and the heading text, so that
2608+\f[C]#5 bolt\f[R] and \f[C]#hashtag\f[R] count as headings.
25572609With this extension, pandoc does require the space.
2558−.SS Header identifiers
2610+.SS Heading identifiers
25592611.PP
25602612See also the \f[C]auto_identifiers\f[R] extension above.
25612613.SS Extension: \f[C]header_attributes\f[R]
25622614.PP
2563−Headers can be assigned attributes using this syntax at the end of the
2564−line containing the header text:
2615+Headings can be assigned attributes using this syntax at the end of the
2616+line containing the heading text:
25652617.IP
25662618.nf
25672619\f[C]
@@ -2569,16 +2621,16 @@ line containing the header text:
25692621\f[R]
25702622.fi
25712623.PP
2572−Thus, for example, the following headers will all be assigned the
2624+Thus, for example, the following headings will all be assigned the
25732625identifier \f[C]foo\f[R]:
25742626.IP
25752627.nf
25762628\f[C]
2577−# My header {#foo}
2629+# My heading {#foo}
25782630
2579−## My header ## {#foo}
2631+## My heading ## {#foo}
25802632
2581−My other header {#foo}
2633+My other heading {#foo}
25822634---------------
25832635\f[R]
25842636.fi
@@ -2593,7 +2645,7 @@ HTML-based formats such as EPUB and slidy.
25932645Identifiers are used for labels and link anchors in the LaTeX, ConTeXt,
25942646Textile, and AsciiDoc writers.
25952647.PP
2596−Headers with the class \f[C]unnumbered\f[R] will not be numbered, even
2648+Headings with the class \f[C]unnumbered\f[R] will not be numbered, even
25972649if \f[C]--number-sections\f[R] is specified.
25982650A single hyphen (\f[C]-\f[R]) in an attribute context is equivalent to
25992651\f[C].unnumbered\f[R], and preferable in non-English documents.
@@ -2601,7 +2653,7 @@ So,
26012653.IP
26022654.nf
26032655\f[C]
2604−# My header {-}
2656+# My heading {-}
26052657\f[R]
26062658.fi
26072659.PP
@@ -2609,17 +2661,17 @@ is just the same as
26092661.IP
26102662.nf
26112663\f[C]
2612−# My header {.unnumbered}
2664+# My heading {.unnumbered}
26132665\f[R]
26142666.fi
26152667.SS Extension: \f[C]implicit_header_references\f[R]
26162668.PP
2617−Pandoc behaves as if reference links have been defined for each header.
2618−So, to link to a header
2669+Pandoc behaves as if reference links have been defined for each heading.
2670+So, to link to a heading
26192671.IP
26202672.nf
26212673\f[C]
2622−# Header identifiers in HTML
2674+# Heading identifiers in HTML
26232675\f[R]
26242676.fi
26252677.PP
@@ -2627,7 +2679,7 @@ you can simply write
26272679.IP
26282680.nf
26292681\f[C]
2630−[Header identifiers in HTML]
2682+[Heading identifiers in HTML]
26312683\f[R]
26322684.fi
26332685.PP
@@ -2635,7 +2687,7 @@ or
26352687.IP
26362688.nf
26372689\f[C]
2638−[Header identifiers in HTML][]
2690+[Heading identifiers in HTML][]
26392691\f[R]
26402692.fi
26412693.PP
@@ -2643,7 +2695,7 @@ or
26432695.IP
26442696.nf
26452697\f[C]
2646−[the section on header identifiers][header identifiers in
2698+[the section on heading identifiers][heading identifiers in
26472699HTML]
26482700\f[R]
26492701.fi
@@ -2652,18 +2704,18 @@ instead of giving the identifier explicitly:
26522704.IP
26532705.nf
26542706\f[C]
2655−[Header identifiers in HTML](#header-identifiers-in-html)
2707+[Heading identifiers in HTML](#heading-identifiers-in-html)
26562708\f[R]
26572709.fi
26582710.PP
2659−If there are multiple headers with identical text, the corresponding
2711+If there are multiple headings with identical text, the corresponding
26602712reference will link to the first one only, and you will need to use
26612713explicit links to link to the others, as described above.
26622714.PP
26632715Like regular reference links, these references are case-insensitive.
26642716.PP
26652717Explicit link reference definitions always take priority over implicit
2666−header references.
2718+heading references.
26672719So, in the following example, the link will point to \f[C]bar\f[R], not
26682720to \f[C]#foo\f[R]:
26692721.IP
@@ -2680,7 +2732,7 @@ See [foo]
26802732.PP
26812733Markdown uses email conventions for quoting blocks of text.
26822734A block quotation is one or more paragraphs or other block elements
2683−(such as lists or headers), with each line preceded by a \f[C]>\f[R]
2735+(such as lists or headings), with each line preceded by a \f[C]>\f[R]
26842736character and an optional space.
26852737(The \f[C]>\f[R] need not start at the left margin, but it should not be
26862738indented more than three spaces.)
@@ -3373,7 +3425,7 @@ Table: Demonstration of simple table syntax.
33733425\f[R]
33743426.fi
33753427.PP
3376−The headers and table rows must each fit on one line.
3428+The header and table rows must each fit on one line.
33773429Column alignments are determined by the position of the header text
33783430relative to the dashed line below it:
33793431.IP \[bu] 2
@@ -3392,8 +3444,8 @@ default alignment is used (in most cases, this will be left).
33923444The table must end with a blank line, or a line of dashes followed by a
33933445blank line.
33943446.PP
3395−The column headers may be omitted, provided a dashed line is used to end
3396−the table.
3447+The column header row may be omitted, provided a dashed line is used to
3448+end the table.
33973449For example:
33983450.IP
33993451.nf
@@ -3406,13 +3458,13 @@ For example:
34063458\f[R]
34073459.fi
34083460.PP
3409−When headers are omitted, column alignments are determined on the basis
3410−of the first line of the table body.
3461+When the header row is omitted, column alignments are determined on the
3462+basis of the first line of the table body.
34113463So, in the tables above, the columns would be right, left, center, and
34123464right aligned, respectively.
34133465.SS Extension: \f[C]multiline_tables\f[R]
34143466.PP
3415−Multiline tables allow headers and table rows to span multiple lines of
3467+Multiline tables allow header and table rows to span multiple lines of
34163468text (but cells that span multiple columns or rows of the table are not
34173469supported).
34183470Here is an example:
@@ -3439,7 +3491,7 @@ multiple lines.
34393491These work like simple tables, but with the following differences:
34403492.IP \[bu] 2
34413493They must begin with a row of dashes, before the header text (unless the
3442−headers are omitted).
3494+header row is omitted).
34433495.IP \[bu] 2
34443496They must end with a row of dashes, then a blank line.
34453497.IP \[bu] 2
@@ -3451,7 +3503,7 @@ the output.
34513503So, if you find that one of the columns is too narrow in the output, try
34523504widening it in the Markdown source.
34533505.PP
3454−Headers may be omitted in multiline tables as well as simple tables:
3506+The header may be omitted in multiline tables as well as simple tables:
34553507.IP
34563508.nf
34573509\f[C]
@@ -3464,7 +3516,7 @@ Headers may be omitted in multiline tables as well as simple tables:
34643516 rows.
34653517----------- ------- --------------- -------------------------
34663518
3467−: Here\[aq]s a multiline table without headers.
3519+: Here\[aq]s a multiline table without a header.
34683520\f[R]
34693521.fi
34703522.PP
@@ -4057,6 +4109,10 @@ inline math) or \f[C]\[rs][...\[rs]]\f[R] (for display math).
40574109It will appear verbatim surrounded by \f[C]$...$\f[R] (for inline math)
40584110or \f[C]$$...$$\f[R] (for display math).
40594111.TP
4112+.B XWiki
4113+It will appear verbatim surrounded by
4114+\f[C]{{formula}}..{{/formula}}\f[R].
4115+.TP
40604116.B reStructuredText
40614117It will be rendered using an interpreted text role \f[C]:math:\f[R].
40624118.TP
@@ -4439,7 +4495,7 @@ See [my website].
44394495.SS Internal links
44404496.PP
44414497To link to another section of the same document, use the automatically
4442−generated identifier (see Header identifiers).
4498+generated identifier (see Heading identifiers).
44434499For example:
44444500.IP
44454501.nf
@@ -4949,8 +5005,8 @@ Otherwise, it will be placed at the end of the document.
49495005Generation of the bibliography can be suppressed by setting
49505006\f[C]suppress-bibliography: true\f[R] in the YAML metadata.
49515007.PP
4952−If you wish the bibliography to have a section header, you can set
4953−\f[C]reference-section-title\f[R] in the metadata, or put the header at
5008+If you wish the bibliography to have a section heading, you can set
5009+\f[C]reference-section-title\f[R] in the metadata, or put the heading at
49545010the beginning of the div with id \f[C]refs\f[R] (if you are using it) or
49555011at the end of your document:
49565012.IP
@@ -4962,8 +5018,8 @@ last paragraph...
49625018\f[R]
49635019.fi
49645020.PP
4965−The bibliography will be inserted after this header.
4966−Note that the \f[C]unnumbered\f[R] class will be added to this header,
5021+The bibliography will be inserted after this heading.
5022+Note that the \f[C]unnumbered\f[R] class will be added to this heading,
49675023so that the section will not be numbered.
49685024.PP
49695025If you want to include items in the bibliography without actually citing
@@ -5136,8 +5192,9 @@ This is a reference ![image][ref] with multimarkdown attributes.
51365192.fi
51375193.SS Extension: \f[C]mmd_header_identifiers\f[R]
51385194.PP
5139−Parses multimarkdown style header identifiers (in square brackets, after
5140−the header but before any trailing \f[C]#\f[R]s in an ATX header).
5195+Parses multimarkdown style heading identifiers (in square brackets,
5196+after the heading but before any trailing \f[C]#\f[R]s in an ATX
5197+heading).
51415198.SS Extension: \f[C]compact_definition_lists\f[R]
51425199.PP
51435200Activates the definition list syntax of pandoc 1.12.x and earlier.
@@ -5306,26 +5363,26 @@ pandoc habits.txt -o habits.pptx
53065363.fi
53075364.SS Structuring the slide show
53085365.PP
5309−By default, the \f[I]slide level\f[R] is the highest header level in the
5310−hierarchy that is followed immediately by content, and not another
5311−header, somewhere in the document.
5312−In the example above, level 1 headers are always followed by level 2
5313−headers, which are followed by content, so 2 is the slide level.
5366+By default, the \f[I]slide level\f[R] is the highest heading level in
5367+the hierarchy that is followed immediately by content, and not another
5368+heading, somewhere in the document.
5369+In the example above, level-1 headings are always followed by level-2
5370+headings, which are followed by content, so the slide level is 2.
53145371This default can be overridden using the \f[C]--slide-level\f[R] option.
53155372.PP
53165373The document is carved up into slides according to the following rules:
53175374.IP \[bu] 2
53185375A horizontal rule always starts a new slide.
53195376.IP \[bu] 2
5320−A header at the slide level always starts a new slide.
5377+A heading at the slide level always starts a new slide.
53215378.IP \[bu] 2
5322−Headers \f[I]below\f[R] the slide level in the hierarchy create headers
5323−\f[I]within\f[R] a slide.
5379+Headings \f[I]below\f[R] the slide level in the hierarchy create
5380+headings \f[I]within\f[R] a slide.
53245381.IP \[bu] 2
5325−Headers \f[I]above\f[R] the slide level in the hierarchy create
5382+Headings \f[I]above\f[R] the slide level in the hierarchy create
53265383\[dq]title slides,\[dq] which just contain the section title and help to
53275384break the slide show into sections.
5328−Non-slide content under these headers will be included on the title
5385+Non-slide content under these headings will be included on the title
53295386slide (for HTML slide shows) or in a subsequent slide with the same
53305387title (for beamer).
53315388.IP \[bu] 2
@@ -5336,13 +5393,13 @@ lines in the default template.)
53365393.PP
53375394These rules are designed to support many different styles of slide show.
53385395If you don\[aq]t care about structuring your slides into sections and
5339−subsections, you can just use level 1 headers for all each slide.
5340−(In that case, level 1 will be the slide level.) But you can also
5396+subsections, you can just use level-1 headings for all each slide.
5397+(In that case, level-1 will be the slide level.) But you can also
53415398structure the slide show into sections, as in the example above.
53425399.PP
53435400Note: in reveal.js slide shows, if slide level is 2, a two-dimensional
5344−layout will be produced, with level 1 headers building horizontally and
5345−level 2 headers building vertically.
5401+layout will be produced, with level-1 headings building horizontally and
5402+level-2 headings building vertically.
53465403It is not recommended that you use deeper nesting of section levels with
53475404reveal.js.
53485405.SS Incremental lists
@@ -5448,10 +5505,10 @@ pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf
54485505\f[R]
54495506.fi
54505507.PP
5451−Note that header attributes will turn into slide attributes (on a
5508+Note that heading attributes will turn into slide attributes (on a
54525509\f[C]<div>\f[R] or \f[C]<section>\f[R]) in HTML slide formats, allowing
54535510you to style individual slides.
5454−In beamer, the only header attribute that affects slides is the
5511+In beamer, the only heading attribute that affects slides is the
54555512\f[C]allowframebreaks\f[R] class, which sets the
54565513\f[C]allowframebreaks\f[R] option, causing multiple slides to be created
54575514if the content overfills the frame.
@@ -5510,7 +5567,7 @@ contents...
55105567Sometimes it is necessary to add the LaTeX \f[C][fragile]\f[R] option to
55115568a frame in beamer (for example, when using the \f[C]minted\f[R]
55125569environment).
5513−This can be forced by adding the \f[C]fragile\f[R] class to the header
5570+This can be forced by adding the \f[C]fragile\f[R] class to the heading
55145571introducing the slide:
55155572.IP
55165573.nf
@@ -5543,7 +5600,7 @@ You can also set \f[C]parallaxBackgroundHorizontal\f[R] and
55435600.PP
55445601To set an image for a particular reveal.js slide, add
55455602\f[C]{data-background-image=\[dq]/path/to/image\[dq]}\f[R] to the first
5546−slide-level header on the slide (which may even be empty).
5603+slide-level heading on the slide (which may even be empty).
55475604.PP
55485605In reveal.js\[aq]s overview mode, the parallaxBackgroundImage will show
55495606up only on the first slide.
@@ -5570,7 +5627,7 @@ Slide 1 has background_image.png as its background.
55705627
55715628## {data-background-image=\[dq]/path/to/special_image.jpg\[dq]}
55725629
5573−Slide 2 has a special image for its background, even though the header has no content.
5630+Slide 2 has a special image for its background, even though the heading has no content.
55745631\f[R]
55755632.fi
55765633.SH CREATING EPUBS WITH PANDOC
@@ -5697,7 +5754,7 @@ iBooks-specific metadata, with the following fields:
56975754.RE
56985755.SS The \f[C]epub:type\f[R] attribute
56995756.PP
5700−For \f[C]epub3\f[R] output, you can mark up the header that corresponds
5757+For \f[C]epub3\f[R] output, you can mark up the heading that corresponds
57015758to an EPUB chapter using the \f[C]epub:type\f[R] attribute.
57025759For example, to set the attribute to the value \f[C]prologue\f[R], use
57035760this markdown:
@@ -5954,6 +6011,13 @@ To avoid using raw HTML or TeX except when marked explicitly using raw
59546011attributes, we recommend specifying the extensions
59556012\f[C]-raw_html-raw_tex+raw_attribute\f[R] when translating between
59566013Markdown and ipynb notebooks.
6014+.PP
6015+Note that options and extensions that affect reading and writing of
6016+Markdown will also affect Markdown cells in ipynb notebooks.
6017+For example, \f[C]--wrap=preserve\f[R] will preserve soft line breaks in
6018+Markdown cells; \f[C]--atx-headers\f[R] will cause ATX-style headings to
6019+be used; and \f[C]--preserve-tabs\f[R] will prevent tabs from being
6020+turned to spaces.
59576021.SH SYNTAX HIGHLIGHTING
59586022.PP
59596023Pandoc will automatically highlight syntax in fenced code blocks that
@@ -6168,7 +6232,7 @@ The HTML generated by pandoc is not guaranteed to be safe.
61686232If \f[C]raw_html\f[R] is enabled for the Markdown input, users can
61696233inject arbitrary HTML.
61706234Even if \f[C]raw_html\f[R] is disabled, users can include dangerous
6171−content in attributes for headers, spans, and code blocks.
6235+content in attributes for headings, spans, and code blocks.
61726236To be safe, you should run all the generated HTML through an HTML
61736237sanitizer.
61746238.SH AUTHORS