@@ -930,7 +930,7 @@ A paragraph is one or more lines of text followed by one or more blank line.
930930Newlines are treated as spaces, so you can reflow your paragraphs as you like.
931931If you need a hard line break, put two or more spaces at the end of a line.
932932
933−**Extension: `escaped_line_breaks`**
933+### Extension: `escaped_line_breaks` ###
934934
935935A backslash followed by a newline is also a hard line break.
936936Note: in multiline and grid table cells, this is the only way
@@ -971,7 +971,7 @@ As with setext-style headers, the header text can contain formatting:
971971
972972 # A level-one header with a [link](/url) and *emphasis*
973973
974−**Extension: `blank_before_header`**
974+#### Extension: `blank_before_header` ####
975975
976976Standard markdown syntax does not require a blank line before a header.
977977Pandoc does require this (except, of course, at the beginning of the
@@ -985,7 +985,7 @@ wrapping). Consider, for example:
985985
986986### Header identifiers in HTML, LaTeX, and ConTeXt ###
987987
988−**Extension: `header_attributes`**
988+#### Extension: `header_attributes` ####
989989
990990Headers can be assigned attributes using this syntax at the end
991991of the line containing the header text:
@@ -1021,7 +1021,7 @@ is just the same as
10211021
10221022 # My header {.unnumbered}
10231023
1024−**Extension: `auto_identifiers`**
1024+#### Extension: `auto_identifiers` ####
10251025
10261026A header without an explicitly specified identifier will be
10271027automatically assigned a unique identifier based on the header text.
@@ -1070,7 +1070,7 @@ and the identifier will be attached to the enclosing `<div>`
10701070sections to be manipulated using javascript or treated differently in
10711071CSS.
10721072
1073−**Extension: `implicit_header_references`**
1073+#### Extension: `implicit_header_references` ####
10741074
10751075Pandoc behaves as if reference links have been defined for each header.
10761076So, instead of
@@ -1129,7 +1129,7 @@ other block quotes. That is, block quotes can be nested:
11291129 >
11301130 > > A block quote within a block quote.
11311131
1132−**Extension: `blank_before_blockquote`**
1132+### Extension: `blank_before_blockquote` ###
11331133
11341134Standard markdown syntax does not require a blank line before a block
11351135quote. Pandoc does require this (except, of course, at the beginning of the
@@ -1163,7 +1163,7 @@ Note: blank lines in the verbatim text need not begin with four spaces.
11631163
11641164### Fenced code blocks ###
11651165
1166−**Extension: `fenced_code_blocks`**
1166+#### Extension: `fenced_code_blocks` ####
11671167
11681168In addition to standard indented code blocks, Pandoc supports
11691169*fenced* code blocks. These begin with a row of three or more
@@ -1189,7 +1189,7 @@ row of tildes or backticks at the start and end:
11891189 ~~~~~~~~~~
11901190 ~~~~~~~~~~~~~~~~
11911191
1192−**Extension: `fenced_code_attributes`**
1192+#### Extension: `fenced_code_attributes` ####
11931193
11941194Optionally, you may attach attributes to the code block using
11951195this syntax:
@@ -1238,7 +1238,7 @@ To set the highlighting style, use `--highlight-style`.
12381238Line blocks
12391239-----------
12401240
1241−**Extension: `line_blocks`**
1241+### Extension: `line_blocks` ###
12421242
12431243A line block is a sequence of lines beginning with a vertical bar (`|`)
12441244followed by a space. The division into lines will be preserved in
@@ -1380,7 +1380,7 @@ and this one:
13801380 7. two
13811381 1. three
13821382
1383−**Extension: `fancy_lists`**
1383+#### Extension: `fancy_lists` ####
13841384
13851385Unlike standard markdown, Pandoc allows ordered list items to be marked
13861386with uppercase and lowercase letters and roman numerals, in addition to
@@ -1411,7 +1411,7 @@ ordered list marker in place of a numeral:
14111411 #. one
14121412 #. two
14131413
1414−**Extension: `startnum`**
1414+#### Extension: `startnum` ####
14151415
14161416Pandoc also pays attention to the type of list marker used, and to the
14171417starting number, and both of these are preserved where possible in the
@@ -1443,7 +1443,7 @@ If default list markers are desired, use `#.`:
14431443
14441444### Definition lists ###
14451445
1446−**Extension: `definition_lists`**
1446+#### Extension: `definition_lists` ####
14471447
14481448Pandoc supports definition lists, using the syntax of
14491449[PHP Markdown Extra] with some extensions.[^3]
@@ -1504,7 +1504,7 @@ hard wrapping, can be activated with `compact_definition_lists`: see
15041504
15051505### Numbered example lists ###
15061506
1507−**Extension: `example_lists`**
1507+#### Extension: `example_lists` ####
15081508
15091509The special list marker `@` can be used for sequentially numbered
15101510examples. The first list item with a `@` marker will be numbered '1',
@@ -1610,9 +1610,9 @@ Four kinds of tables may be used. The first three kinds presuppose the use of
16101610a fixed-width font, such as Courier. The fourth kind can be used with
16111611proportionally spaced fonts, as it does not require lining up columns.
16121612
1613−### Simple tables
1613+### Simple tables ###
16141614
1615−**Extension: `simple_tables`, `table_captions`**
1615+#### Extension: `simple_tables`, `table_captions` ####
16161616
16171617Simple tables look like this:
16181618
@@ -1659,9 +1659,9 @@ When headers are omitted, column alignments are determined on the basis
16591659of the first line of the table body. So, in the tables above, the columns
16601660would be right, left, center, and right aligned, respectively.
16611661
1662−### Multiline tables
1662+### Multiline tables ###
16631663
1664−**Extension: `multiline_tables`, `table_captions`**
1664+#### Extension: `multiline_tables`, `table_captions` ####
16651665
16661666Multiline tables allow headers and table rows to span multiple lines
16671667of text (but cells that span multiple columns or rows of the table are
@@ -1711,9 +1711,9 @@ It is possible for a multiline table to have just one row, but the row
17111711should be followed by a blank line (and then the row of dashes that ends
17121712the table), or the table may be interpreted as a simple table.
17131713
1714−### Grid tables
1714+### Grid tables ###
17151715
1716−**Extension: `grid_tables`, `table_captions`**
1716+#### Extension: `grid_tables`, `table_captions` ####
17171717
17181718Grid tables look like this:
17191719
@@ -1737,9 +1737,9 @@ columns or rows. Grid tables can be created easily using [Emacs table mode].
17371737
17381738 [Emacs table mode]: http://table.sourceforge.net/
17391739
1740−### Pipe tables
1740+### Pipe tables ###
17411741
1742−**Extension: `pipe_tables`, `table_captions`**
1742+#### Extension: `pipe_tables`, `table_captions` ####
17431743
17441744Pipe tables look like this:
17451745
@@ -1788,7 +1788,7 @@ you'll need to add colons as above.
17881788Title block
17891789-----------
17901790
1791−**Extension: `pandoc_title_block`**
1791+### Extension: `pandoc_title_block` ###
17921792
17931793If the file begins with a title block
17941794
@@ -1867,7 +1867,7 @@ will also have "Version 4.0" in the header.
18671867YAML metadata block
18681868-------------------
18691869
1870−**Extension: `yaml_metadata_block`**
1870+### Extension: `yaml_metadata_block` ###
18711871
18721872A YAML metadata block is a valid YAML object, delimited by a line of three
18731873hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
@@ -1935,7 +1935,7 @@ custom template. For example:
19351935Backslash escapes
19361936-----------------
19371937
1938−**Extension: `all_symbols_escapable`**
1938+### Extension: `all_symbols_escapable` ###
19391939
19401940Except inside a code block or inline code, any punctuation or space
19411941character preceded by a backslash will be treated literally, even if it
@@ -1974,7 +1974,7 @@ Backslash escapes do not work in verbatim contexts.
19741974Smart punctuation
19751975-----------------
19761976
1977−**Extension**
1977+### Extension ###
19781978
19791979If the `--smart` option is specified, pandoc will produce typographically
19801980correct output, converting straight quotes to curly quotes, `---` to
@@ -2003,7 +2003,7 @@ will not trigger emphasis:
20032003
20042004 This is * not emphasized *, and \*neither is this\*.
20052005
2006−**Extension: `intraword_underscores`**
2006+#### Extension: `intraword_underscores` ####
20072007
20082008Because `_` is sometimes used inside words and identifiers,
20092009pandoc does not interpret a `_` surrounded by alphanumeric
@@ -2015,7 +2015,7 @@ just part of a word, use `*`:
20152015
20162016### Strikeout ###
20172017
2018−**Extension: `strikeout`**
2018+#### Extension: `strikeout` ####
20192019
20202020To strikeout a section of text with a horizontal line, begin and end it
20212021with `~~`. Thus, for example,
@@ -2025,7 +2025,7 @@ with `~~`. Thus, for example,
20252025
20262026### Superscripts and subscripts ###
20272027
2028−**Extension: `superscript`, `subscript`**
2028+#### Extension: `superscript`, `subscript` ####
20292029
20302030Superscripts may be written by surrounding the superscripted text by `^`
20312031characters; subscripts may be written by surrounding the subscripted
@@ -2063,7 +2063,7 @@ work in verbatim contexts:
20632063
20642064 This is a backslash followed by an asterisk: `\*`.
20652065
2066−**Extension: `inline_code_attributes`**
2066+#### Extension: `inline_code_attributes` ####
20672067
20682068Attributes can be attached to verbatim text, just as with
20692069[fenced code blocks](#fenced-code-blocks):
@@ -2082,7 +2082,7 @@ colon.) This will work in all output formats that support small caps.
20822082Math
20832083----
20842084
2085−**Extension: `tex_math_dollars`**
2085+### Extension: `tex_math_dollars` ###
20862086
20872087Anything between two `$` characters will be treated as TeX math. The
20882088opening `$` must have a character immediately to its right, while the
@@ -2184,7 +2184,7 @@ HTML, Slidy, DZSlides, S5, EPUB
21842184Raw HTML
21852185--------
21862186
2187−**Extension: `raw_html`**
2187+### Extension: `raw_html` ###
21882188
21892189Markdown allows you to insert raw HTML (or DocBook) anywhere in a document
21902190(except verbatim contexts, where `<`, `>`, and `&` are interpreted
@@ -2196,7 +2196,7 @@ The raw HTML is passed through unchanged in HTML, S5, Slidy, Slideous,
21962196DZSlides, EPUB, Markdown, and Textile output, and suppressed in other
21972197formats.
21982198
2199−**Extension: `markdown_in_html_blocks`**
2199+### Extension: `markdown_in_html_blocks` ###
22002200
22012201Standard markdown allows you to include HTML "blocks": blocks
22022202of HTML between balanced tags that are separated from the surrounding text
@@ -2237,7 +2237,7 @@ from being interpreted as markdown.
22372237Raw TeX
22382238-------
22392239
2240−**Extension: `raw_tex`**
2240+### Extension: `raw_tex` ###
22412241
22422242In addition to raw HTML, pandoc allows raw LaTeX, TeX, and ConTeXt to be
22432243included in a document. Inline TeX commands will be preserved and passed
@@ -2264,7 +2264,7 @@ and ConTeXt.
22642264LaTeX macros
22652265------------
22662266
2267−**Extension: `latex_macros`**
2267+### Extension: `latex_macros` ###
22682268
22692269For output formats other than LaTeX, pandoc will parse LaTeX `\newcommand` and
22702270`\renewcommand` definitions and apply the resulting macros to all LaTeX
@@ -2356,7 +2356,7 @@ not in most other implementations:
23562356 >
23572357 > [quote]: /foo
23582358
2359−### Internal links
2359+### Internal links ###
23602360
23612361To link to another section of the same document, use the automatically
23622362generated identifier (see [Header identifiers in HTML, LaTeX, and
@@ -2388,7 +2388,7 @@ The link text will be used as the image's alt text:
23882388
23892389### Pictures with captions ###
23902390
2391−**Extension: `implicit_figures`**
2391+#### Extension: `implicit_figures` ####
23922392
23932393An image occurring by itself in a paragraph will be rendered as
23942394a figure with a caption.[^5] (In LaTeX, a figure environment will be
@@ -2412,7 +2412,7 @@ nonbreaking space after the image:
24122412Footnotes
24132413---------
24142414
2415−**Extension: `footnotes`**
2415+### Extension: `footnotes` ###
24162416
24172417Pandoc's markdown allows footnotes, using the following syntax:
24182418
@@ -2443,7 +2443,7 @@ The footnotes themselves need not be placed at the end of the
24432443document. They may appear anywhere except inside other block elements
24442444(lists, block quotes, tables, etc.).
24452445
2446−**Extension: `inline_notes`**
2446+### Extension: `inline_notes` ###
24472447
24482448Inline footnotes are also allowed (though, unlike regular notes,
24492449they cannot contain multiple paragraphs). The syntax is as follows:
@@ -2458,7 +2458,7 @@ Inline and regular footnotes may be mixed freely.
24582458Citations
24592459---------
24602460
2461−**Extension: `citations`**
2461+### Extension: `citations` ###
24622462
24632463Using an external filter, `pandoc-citeproc`, pandoc can automatically generate
24642464citations and a bibliography in a number of styles. Basic usage is
@@ -2580,37 +2580,37 @@ in pandoc, but may be enabled by adding `+EXTENSION` to the format
25802580name, where `EXTENSION` is the name of the extension. Thus, for
25812581example, `markdown+hard_line_breaks` is markdown with hard line breaks.
25822582
2583−**Extension: `lists_without_preceding_blankline`**\
2583+### Extension: `lists_without_preceding_blankline` ###
25842584Allow a list to occur right after a paragraph, with no intervening
25852585blank space.
25862586
2587−**Extension: `hard_line_breaks`**\
2587+### Extension: `hard_line_breaks` ###
25882588Causes all newlines within a paragraph to be interpreted as hard line
25892589breaks instead of spaces.
25902590
2591−**Extension: `ignore_line_breaks`**\
2591+### Extension: `ignore_line_breaks` ###
25922592Causes newlines within a paragraph to be ignored, rather than being
25932593treated as spaces or as hard line breaks. This option is intended for
25942594use with East Asian languages where spaces are not used between words,
25952595but text is divided into lines for readability.
25962596
2597−**Extension: `tex_math_single_backslash`**\
2597+### Extension: `tex_math_single_backslash` ###
25982598Causes anything between `\(` and `\)` to be interpreted as inline
25992599TeX math, and anything between `\[` and `\]` to be interpreted
26002600as display TeX math. Note: a drawback of this extension is that
26012601it precludes escaping `(` and `[`.
26022602
2603−**Extension: `tex_math_double_backslash`**\
2603+### Extension: `tex_math_double_backslash` ###
26042604Causes anything between `\\(` and `\\)` to be interpreted as inline
26052605TeX math, and anything between `\\[` and `\\]` to be interpreted
26062606as display TeX math.
26072607
2608−**Extension: `markdown_attribute`**\
2608+### Extension: `markdown_attribute` ###
26092609By default, pandoc interprets material inside block-level tags as markdown.
26102610This extension changes the behavior so that markdown is only parsed
26112611inside block-level tags if the tags have the attribute `markdown=1`.
26122612
2613−**Extension: `mmd_title_block`**\
2613+### Extension: `mmd_title_block` ###
26142614Enables a [MultiMarkdown] style title block at the top of
26152615the document, for example:
26162616
@@ -2626,7 +2626,7 @@ See the MultiMarkdown documentation for details. If `pandoc_title_block` or
26262626
26272627 [MultiMarkdown]: http://fletcherpenney.net/multimarkdown/
26282628
2629−**Extension: `abbreviations`**\
2629+### Extension: `abbreviations` ###
26302630Parses PHP Markdown Extra abbreviation keys, like
26312631
26322632 *[HTML]: Hyper Text Markup Language
@@ -2635,25 +2635,25 @@ Note that the pandoc document model does not support
26352635abbreviations, so if this extension is enabled, abbreviation keys are
26362636simply skipped (as opposed to being parsed as paragraphs).
26372637
2638−**Extension: `autolink_bare_uris`**\
2638+### Extension: `autolink_bare_uris` ###
26392639Makes all absolute URIs into links, even when not surrounded by
26402640pointy braces `<...>`.
26412641
2642−**Extension: `ascii_identifiers`**\
2642+### Extension: `ascii_identifiers` ###
26432643Causes the identifiers produced by `auto_identifiers` to be pure ASCII.
26442644Accents are stripped off of accented latin letters, and non-latin
26452645letters are omitted.
26462646
2647−**Extension: `link_attributes`**\
2647+### Extension: `link_attributes` ###
26482648Parses multimarkdown style key-value attributes on link and image references.
26492649Note that pandoc's internal document model provides nowhere to put
26502650these, so they are presently just ignored.
26512651
2652−**Extension: `mmd_header_identifiers`**\
2652+### Extension: `mmd_header_identifiers` ###
26532653Parses multimarkdown style header identifiers (in square brackets,
26542654after the header but before any trailing `#`s in an ATX header).
26552655
2656−**Extension: `compact_definition_lists`**\
2656+### Extension: `compact_definition_lists` ###
26572657Activates the definition list syntax of pandoc 1.12.x and earlier.
26582658This syntax differs from the one described [above](#definition-lists)
26592659in several respects: