@@ -936,7 +936,7 @@ A paragraph is one or more lines of text followed by one or more blank line.
936936Newlines are treated as spaces, so you can reflow your paragraphs as you like.
937937If you need a hard line break, put two or more spaces at the end of a line.
938938
939−**Extension: `escaped_line_breaks`**
939+#### Extension: `escaped_line_breaks` ####
940940
941941A backslash followed by a newline is also a hard line break.
942942Note: in multiline and grid table cells, this is the only way
@@ -977,7 +977,7 @@ As with setext-style headers, the header text can contain formatting:
977977
978978 # A level-one header with a [link](/url) and *emphasis*
979979
980−**Extension: `blank_before_header`**
980+#### Extension: `blank_before_header` ####
981981
982982Standard markdown syntax does not require a blank line before a header.
983983Pandoc does require this (except, of course, at the beginning of the
@@ -991,7 +991,7 @@ wrapping). Consider, for example:
991991
992992### Header identifiers in HTML, LaTeX, and ConTeXt ###
993993
994−**Extension: `header_attributes`**
994+#### Extension: `header_attributes` ####
995995
996996Headers can be assigned attributes using this syntax at the end
997997of the line containing the header text:
@@ -1027,7 +1027,7 @@ is just the same as
10271027
10281028 # My header {.unnumbered}
10291029
1030−**Extension: `auto_identifiers`**
1030+#### Extension: `auto_identifiers` ####
10311031
10321032A header without an explicitly specified identifier will be
10331033automatically assigned a unique identifier based on the header text.
@@ -1076,7 +1076,7 @@ and the identifier will be attached to the enclosing `<div>`
10761076sections to be manipulated using javascript or treated differently in
10771077CSS.
10781078
1079−**Extension: `implicit_header_references`**
1079+#### Extension: `implicit_header_references` ####
10801080
10811081Pandoc behaves as if reference links have been defined for each header.
10821082So, instead of
@@ -1135,7 +1135,7 @@ other block quotes. That is, block quotes can be nested:
11351135 >
11361136 > > A block quote within a block quote.
11371137
1138−**Extension: `blank_before_blockquote`**
1138+#### Extension: `blank_before_blockquote` ####
11391139
11401140Standard markdown syntax does not require a blank line before a block
11411141quote. Pandoc does require this (except, of course, at the beginning of the
@@ -1169,7 +1169,7 @@ Note: blank lines in the verbatim text need not begin with four spaces.
11691169
11701170### Fenced code blocks ###
11711171
1172−**Extension: `fenced_code_blocks`**
1172+#### Extension: `fenced_code_blocks` ####
11731173
11741174In addition to standard indented code blocks, Pandoc supports
11751175*fenced* code blocks. These begin with a row of three or more
@@ -1195,7 +1195,7 @@ row of tildes or backticks at the start and end:
11951195 ~~~~~~~~~~
11961196 ~~~~~~~~~~~~~~~~
11971197
1198−**Extension: `fenced_code_attributes`**
1198+#### Extension: `fenced_code_attributes` ####
11991199
12001200Optionally, you may attach attributes to the code block using
12011201this syntax:
@@ -1244,7 +1244,7 @@ To set the highlighting style, use `--highlight-style`.
12441244Line blocks
12451245-----------
12461246
1247−**Extension: `line_blocks`**
1247+#### Extension: `line_blocks` ####
12481248
12491249A line block is a sequence of lines beginning with a vertical bar (`|`)
12501250followed by a space. The division into lines will be preserved in
@@ -1386,7 +1386,7 @@ and this one:
13861386 7. two
13871387 1. three
13881388
1389−**Extension: `fancy_lists`**
1389+#### Extension: `fancy_lists` ####
13901390
13911391Unlike standard markdown, Pandoc allows ordered list items to be marked
13921392with uppercase and lowercase letters and roman numerals, in addition to
@@ -1417,7 +1417,7 @@ ordered list marker in place of a numeral:
14171417 #. one
14181418 #. two
14191419
1420−**Extension: `startnum`**
1420+#### Extension: `startnum` ####
14211421
14221422Pandoc also pays attention to the type of list marker used, and to the
14231423starting number, and both of these are preserved where possible in the
@@ -1449,7 +1449,7 @@ If default list markers are desired, use `#.`:
14491449
14501450### Definition lists ###
14511451
1452−**Extension: `definition_lists`**
1452+#### Extension: `definition_lists` ####
14531453
14541454Pandoc supports definition lists, using the syntax of
14551455[PHP Markdown Extra] with some extensions.[^3]
@@ -1510,7 +1510,7 @@ hard wrapping, can be activated with `compact_definition_lists`: see
15101510
15111511### Numbered example lists ###
15121512
1513−**Extension: `example_lists`**
1513+#### Extension: `example_lists` ####
15141514
15151515The special list marker `@` can be used for sequentially numbered
15161516examples. The first list item with a `@` marker will be numbered '1',
@@ -1616,9 +1616,14 @@ Four kinds of tables may be used. The first three kinds presuppose the use of
16161616a fixed-width font, such as Courier. The fourth kind can be used with
16171617proportionally spaced fonts, as it does not require lining up columns.
16181618
1619−### Simple tables
1619+#### Extension: `table_captions` ####
16201620
1621−**Extension: `simple_tables`, `table_captions`**
1621+A caption may optionally be provided with all 4 kinds of tables (as
1622+illustrated in the examples below). A caption is a paragraph beginning
1623+with the string `Table:` (or just `:`), which will be stripped off.
1624+It may appear either before or after the table.
1625+
1626+#### Extension: `simple_tables` ####
16221627
16231628Simple tables look like this:
16241629
@@ -1647,10 +1652,7 @@ to the dashed line below it:[^4]
16471652 [Markdown discussion list](http://six.pairlist.net/pipermail/markdown-discuss/2005-March/001097.html).
16481653
16491654The table must end with a blank line, or a line of dashes followed by
1650−a blank line. A caption may optionally be provided (as illustrated in
1651−the example above). A caption is a paragraph beginning with the string
1652−`Table:` (or just `:`), which will be stripped off. It may appear either
1653−before or after the table.
1655+a blank line.
16541656
16551657The column headers may be omitted, provided a dashed line is used
16561658to end the table. For example:
@@ -1665,9 +1667,7 @@ When headers are omitted, column alignments are determined on the basis
16651667of the first line of the table body. So, in the tables above, the columns
16661668would be right, left, center, and right aligned, respectively.
16671669
1668−### Multiline tables
1669−
1670−**Extension: `multiline_tables`, `table_captions`**
1670+#### Extension: `multiline_tables` ####
16711671
16721672Multiline tables allow headers and table rows to span multiple lines
16731673of text (but cells that span multiple columns or rows of the table are
@@ -1717,9 +1717,7 @@ It is possible for a multiline table to have just one row, but the row
17171717should be followed by a blank line (and then the row of dashes that ends
17181718the table), or the table may be interpreted as a simple table.
17191719
1720−### Grid tables
1721−
1722−**Extension: `grid_tables`, `table_captions`**
1720+#### Extension: `grid_tables` ####
17231721
17241722Grid tables look like this:
17251723
@@ -1743,9 +1741,7 @@ columns or rows. Grid tables can be created easily using [Emacs table mode].
17431741
17441742 [Emacs table mode]: http://table.sourceforge.net/
17451743
1746−### Pipe tables
1747−
1748−**Extension: `pipe_tables`, `table_captions`**
1744+#### Extension: `pipe_tables` ####
17491745
17501746Pipe tables look like this:
17511747
@@ -1755,7 +1751,7 @@ Pipe tables look like this:
17551751 | 123 | 123 | 123 | 123 |
17561752 | 1 | 1 | 1 | 1 |
17571753
1758− : Demonstration of simple table syntax.
1754+ : Demonstration of pipe table syntax.
17591755
17601756The syntax is [the same as in PHP markdown extra]. The beginning and
17611757ending pipe characters are optional, but pipes are required between all
@@ -1794,10 +1790,10 @@ The difference is that `+` is used instead of `|`. Other orgtbl features
17941790are not supported. In particular, to get non-default column alignment,
17951791you'll need to add colons as above.
17961792
1797−Title block
1798−-----------
1793+Metadata blocks
1794+---------------
17991795
1800−**Extension: `pandoc_title_block`**
1796+#### Extension: `pandoc_title_block` ####
18011797
18021798If the file begins with a title block
18031799
@@ -1873,10 +1869,7 @@ will also have "Pandoc User Manuals" in the footer.
18731869
18741870will also have "Version 4.0" in the header.
18751871
1876−YAML metadata block
1877−-------------------
1878−
1879−**Extension: `yaml_metadata_block`**
1872+#### Extension: `yaml_metadata_block` ####
18801873
18811874A YAML metadata block is a valid YAML object, delimited by a line of three
18821875hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
@@ -1944,7 +1937,7 @@ custom template. For example:
19441937Backslash escapes
19451938-----------------
19461939
1947−**Extension: `all_symbols_escapable`**
1940+#### Extension: `all_symbols_escapable` ####
19481941
19491942Except inside a code block or inline code, any punctuation or space
19501943character preceded by a backslash will be treated literally, even if it
@@ -1983,7 +1976,7 @@ Backslash escapes do not work in verbatim contexts.
19831976Smart punctuation
19841977-----------------
19851978
1986−**Extension**
1979+#### Extension ####
19871980
19881981If the `--smart` option is specified, pandoc will produce typographically
19891982correct output, converting straight quotes to curly quotes, `---` to
@@ -2012,7 +2005,7 @@ will not trigger emphasis:
20122005
20132006 This is * not emphasized *, and \*neither is this\*.
20142007
2015−**Extension: `intraword_underscores`**
2008+#### Extension: `intraword_underscores` ####
20162009
20172010Because `_` is sometimes used inside words and identifiers,
20182011pandoc does not interpret a `_` surrounded by alphanumeric
@@ -2024,7 +2017,7 @@ just part of a word, use `*`:
20242017
20252018### Strikeout ###
20262019
2027−**Extension: `strikeout`**
2020+#### Extension: `strikeout` ####
20282021
20292022To strikeout a section of text with a horizontal line, begin and end it
20302023with `~~`. Thus, for example,
@@ -2034,7 +2027,7 @@ with `~~`. Thus, for example,
20342027
20352028### Superscripts and subscripts ###
20362029
2037−**Extension: `superscript`, `subscript`**
2030+#### Extension: `superscript`, `subscript` ####
20382031
20392032Superscripts may be written by surrounding the superscripted text by `^`
20402033characters; subscripts may be written by surrounding the subscripted
@@ -2072,7 +2065,7 @@ work in verbatim contexts:
20722065
20732066 This is a backslash followed by an asterisk: `\*`.
20742067
2075−**Extension: `inline_code_attributes`**
2068+#### Extension: `inline_code_attributes` ####
20762069
20772070Attributes can be attached to verbatim text, just as with
20782071[fenced code blocks](#fenced-code-blocks):
@@ -2091,7 +2084,7 @@ colon.) This will work in all output formats that support small caps.
20912084Math
20922085----
20932086
2094−**Extension: `tex_math_dollars`**
2087+#### Extension: `tex_math_dollars` ####
20952088
20962089Anything between two `$` characters will be treated as TeX math. The
20972090opening `$` must have a character immediately to its right, while the
@@ -2193,7 +2186,7 @@ HTML, Slidy, DZSlides, S5, EPUB
21932186Raw HTML
21942187--------
21952188
2196−**Extension: `raw_html`**
2189+#### Extension: `raw_html` ####
21972190
21982191Markdown allows you to insert raw HTML (or DocBook) anywhere in a document
21992192(except verbatim contexts, where `<`, `>`, and `&` are interpreted
@@ -2205,7 +2198,7 @@ The raw HTML is passed through unchanged in HTML, S5, Slidy, Slideous,
22052198DZSlides, EPUB, Markdown, and Textile output, and suppressed in other
22062199formats.
22072200
2208−**Extension: `markdown_in_html_blocks`**
2201+#### Extension: `markdown_in_html_blocks` ####
22092202
22102203Standard markdown allows you to include HTML "blocks": blocks
22112204of HTML between balanced tags that are separated from the surrounding text
@@ -2246,7 +2239,7 @@ from being interpreted as markdown.
22462239Raw TeX
22472240-------
22482241
2249−**Extension: `raw_tex`**
2242+#### Extension: `raw_tex` ####
22502243
22512244In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
22522245included in a document. Inline TeX commands will be preserved and passed
@@ -2273,7 +2266,7 @@ and ConTeXt.
22732266LaTeX macros
22742267------------
22752268
2276−**Extension: `latex_macros`**
2269+#### Extension: `latex_macros` ####
22772270
22782271For output formats other than LaTeX, pandoc will parse LaTeX `\newcommand` and
22792272`\renewcommand` definitions and apply the resulting macros to all LaTeX
@@ -2365,7 +2358,7 @@ not in most other implementations:
23652358 >
23662359 > [quote]: /foo
23672360
2368−### Internal links
2361+### Internal links ###
23692362
23702363To link to another section of the same document, use the automatically
23712364generated identifier (see [Header identifiers in HTML, LaTeX, and
@@ -2395,9 +2388,7 @@ The link text will be used as the image's alt text:
23952388
23962389 [movie reel]: movie.gif
23972390
2398−### Pictures with captions ###
2399−
2400−**Extension: `implicit_figures`**
2391+#### Extension: `implicit_figures` ####
24012392
24022393An image occurring by itself in a paragraph will be rendered as
24032394a figure with a caption.[^5] (In LaTeX, a figure environment will be
@@ -2421,7 +2412,7 @@ nonbreaking space after the image:
24212412Footnotes
24222413---------
24232414
2424−**Extension: `footnotes`**
2415+#### Extension: `footnotes` ####
24252416
24262417Pandoc's markdown allows footnotes, using the following syntax:
24272418
@@ -2452,7 +2443,7 @@ The footnotes themselves need not be placed at the end of the
24522443document. They may appear anywhere except inside other block elements
24532444(lists, block quotes, tables, etc.).
24542445
2455−**Extension: `inline_notes`**
2446+#### Extension: `inline_notes` ####
24562447
24572448Inline footnotes are also allowed (though, unlike regular notes,
24582449they cannot contain multiple paragraphs). The syntax is as follows:
@@ -2467,7 +2458,7 @@ Inline and regular footnotes may be mixed freely.
24672458Citations
24682459---------
24692460
2470−**Extension: `citations`**
2461+#### Extension: `citations` ####
24712462
24722463Using an external filter, `pandoc-citeproc`, pandoc can automatically generate
24732464citations and a bibliography in a number of styles. Basic usage is
@@ -2589,37 +2580,44 @@ in pandoc, but may be enabled by adding `+EXTENSION` to the format
25892580name, where `EXTENSION` is the name of the extension. Thus, for
25902581example, `markdown+hard_line_breaks` is markdown with hard line breaks.
25912582
2592−**Extension: `lists_without_preceding_blankline`**\
2583+#### Extension: `lists_without_preceding_blankline` ####
2584+
25932585Allow a list to occur right after a paragraph, with no intervening
25942586blank space.
25952587
2596−**Extension: `hard_line_breaks`**\
2588+#### Extension: `hard_line_breaks` ####
2589+
25972590Causes all newlines within a paragraph to be interpreted as hard line
25982591breaks instead of spaces.
25992592
2600−**Extension: `ignore_line_breaks`**\
2593+#### Extension: `ignore_line_breaks` ####
2594+
26012595Causes newlines within a paragraph to be ignored, rather than being
26022596treated as spaces or as hard line breaks. This option is intended for
26032597use with East Asian languages where spaces are not used between words,
26042598but text is divided into lines for readability.
26052599
2606−**Extension: `tex_math_single_backslash`**\
2600+#### Extension: `tex_math_single_backslash` ####
2601+
26072602Causes anything between `\(` and `\)` to be interpreted as inline
26082603TeX math, and anything between `\[` and `\]` to be interpreted
26092604as display TeX math. Note: a drawback of this extension is that
26102605it precludes escaping `(` and `[`.
26112606
2612−**Extension: `tex_math_double_backslash`**\
2607+#### Extension: `tex_math_double_backslash` ####
2608+
26132609Causes anything between `\\(` and `\\)` to be interpreted as inline
26142610TeX math, and anything between `\\[` and `\\]` to be interpreted
26152611as display TeX math.
26162612
2617−**Extension: `markdown_attribute`**\
2613+#### Extension: `markdown_attribute` ####
2614+
26182615By default, pandoc interprets material inside block-level tags as markdown.
26192616This extension changes the behavior so that markdown is only parsed
26202617inside block-level tags if the tags have the attribute `markdown=1`.
26212618
2622−**Extension: `mmd_title_block`**\
2619+#### Extension: `mmd_title_block` ####
2620+
26232621Enables a [MultiMarkdown] style title block at the top of
26242622the document, for example:
26252623
@@ -2635,7 +2633,8 @@ See the MultiMarkdown documentation for details. If `pandoc_title_block` or
26352633
26362634 [MultiMarkdown]: http://fletcherpenney.net/multimarkdown/
26372635
2638−**Extension: `abbreviations`**\
2636+#### Extension: `abbreviations` ####
2637+
26392638Parses PHP Markdown Extra abbreviation keys, like
26402639
26412640 *[HTML]: Hyper Text Markup Language
@@ -2644,25 +2643,30 @@ Note that the pandoc document model does not support
26442643abbreviations, so if this extension is enabled, abbreviation keys are
26452644simply skipped (as opposed to being parsed as paragraphs).
26462645
2647−**Extension: `autolink_bare_uris`**\
2646+#### Extension: `autolink_bare_uris` ####
2647+
26482648Makes all absolute URIs into links, even when not surrounded by
26492649pointy braces `<...>`.
26502650
2651−**Extension: `ascii_identifiers`**\
2651+#### Extension: `ascii_identifiers` ####
2652+
26522653Causes the identifiers produced by `auto_identifiers` to be pure ASCII.
26532654Accents are stripped off of accented latin letters, and non-latin
26542655letters are omitted.
26552656
2656−**Extension: `link_attributes`**\
2657+#### Extension: `link_attributes` ####
2658+
26572659Parses multimarkdown style key-value attributes on link and image references.
26582660Note that pandoc's internal document model provides nowhere to put
26592661these, so they are presently just ignored.
26602662
2661−**Extension: `mmd_header_identifiers`**\
2663+#### Extension: `mmd_header_identifiers` ####
2664+
26622665Parses multimarkdown style header identifiers (in square brackets,
26632666after the header but before any trailing `#`s in an ATX header).
26642667
2665−**Extension: `compact_definition_lists`**\
2668+#### Extension: `compact_definition_lists` ####
2669+
26662670Activates the definition list syntax of pandoc 1.12.x and earlier.
26672671This syntax differs from the one described [above](#definition-lists)
26682672in several respects: