@@ -1346,7 +1346,7 @@ wrapping). Consider, for example:
13461346 #22, for example, and #5.
13471347
13481348
1349−### Header identifiers
1349+### Header identifiers ###
13501350
13511351#### Extension: `header_attributes` ####
13521352
@@ -1538,7 +1538,7 @@ of the verbatim text, and is removed in the output.
15381538Note: blank lines in the verbatim text need not begin with four spaces.
15391539
15401540
1541−### Fenced code blocks
1541+### Fenced code blocks ###
15421542
15431543#### Extension: `fenced_code_blocks` ####
15441544
@@ -1745,7 +1745,7 @@ pandoc interprets it that way.
17451745 [markdown syntax guide]:
17461746 http://daringfireball.net/projects/markdown/syntax#list
17471747
1748−### Ordered lists
1748+### Ordered lists ###
17491749
17501750Ordered lists work just like bulleted lists, except that the items
17511751begin with enumerators rather than bullets.
@@ -1825,7 +1825,7 @@ If default list markers are desired, use `#.`:
18251825 #. three
18261826
18271827
1828−### Definition lists
1828+### Definition lists ###
18291829
18301830#### Extension: `definition_lists` ####
18311831
@@ -2167,7 +2167,7 @@ you'll need to add colons as above.
21672167Metadata blocks
21682168---------------
21692169
2170−#### Extension: `pandoc_title_block`
2170+#### Extension: `pandoc_title_block` ####
21712171
21722172If the file begins with a title block
21732173
@@ -2243,7 +2243,7 @@ will also have "Pandoc User Manuals" in the footer.
22432243
22442244will also have "Version 4.0" in the header.
22452245
2246−#### Extension: `yaml_metadata_block`
2246+#### Extension: `yaml_metadata_block` ####
22472247
22482248A YAML metadata block is a valid YAML object, delimited by a line of three
22492249hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
@@ -2394,7 +2394,7 @@ just part of a word, use `*`:
23942394 feas*ible*, not feas*able*.
23952395
23962396
2397−### Strikeout
2397+### Strikeout ###
23982398
23992399#### Extension: `strikeout` ####
24002400
@@ -2404,7 +2404,7 @@ with `~~`. Thus, for example,
24042404 This ~~is deleted text.~~
24052405
24062406
2407−### Superscripts and subscripts
2407+### Superscripts and subscripts ###
24082408
24092409#### Extension: `superscript`, `subscript` ####
24102410
@@ -2579,7 +2579,7 @@ The raw HTML is passed through unchanged in HTML, S5, Slidy, Slideous,
25792579DZSlides, EPUB, Markdown, and Textile output, and suppressed in other
25802580formats.
25812581
2582−#### Extension: `markdown_in_html_blocks`
2582+#### Extension: `markdown_in_html_blocks` ####
25832583
25842584Standard markdown allows you to include HTML "blocks": blocks
25852585of HTML between balanced tags that are separated from the surrounding text
@@ -2901,9 +2901,28 @@ Note that `pandoc-citeproc --bib2json` and `pandoc-citeproc --bib2yaml`
29012901can produce `.json` and `.yaml` files from any of the supported formats.
29022902
29032903In-field markup: In BibTeX and BibLaTeX databases, pandoc-citeproc parses
2904−a subset of LaTeX markup; in CSL JSON databases, an [HTML-like markup][CSL markup specs];
2905−and in CSL YAML databases, pandoc markdown. `pandoc-citeproc -j` and `-y`
2906−interconvert these markup formats as far as possible.
2904+a subset of LaTeX markup; in CSL YAML databases, pandoc markdown; and in CSL JSON databases, an [HTML-like markup][CSL markup specs]:
2905+
2906+`<i>...</i>`
2907+: italics
2908+
2909+`<b>...</b>`
2910+: bold
2911+
2912+`<span style="font-variant:small-caps;">...</span>` or `<sc>...</sc>`
2913+: small capitals
2914+
2915+`<sub>...</sub>`
2916+: subscript
2917+
2918+`<sup>...</sup>`
2919+: superscript
2920+
2921+`<span class="nocase">...</span>`
2922+: prevent a phrase from being capitalized as title case
2923+
2924+`pandoc-citeproc -j` and `-y` interconvert the CSL JSON
2925+and CSL YAML formats as far as possible.
29072926
29082927As an alternative to specifying a bibliography file, you can include
29092928the citation data directly in the `references` field of the
@@ -2959,13 +2978,15 @@ characters (`:.#$%&-+?<>~/`). Here are some examples:
29592978 Blah blah [@smith04; @doe99].
29602979
29612980`pandoc-citeproc` detects locator terms in the [CSL locale files].
2962−Either abbreviated or unabbreviated forms are accepted. In the `en-US` locale,
2963−locator terms include `book`, `bk.`; `chapter`, `chap.`; `column`, `col.`;
2964−`figure`, `fig.`; `folio`, `fol.`; `number`, `no.`; `line`, `l.`; `note`, `n.`;
2965−`opus`, `op.`; `page`, `p.`; `paragraph`, `para.`; `part`, `pt.`;
2966−`section`, `sec.`; `sub verbo`, `s.v.`; `verse`, `v.`; `volume`, `vol.`
2967−as well as the plural forms of all these. If no locator term is used,
2968−"page" is assumed.
2981+Either abbreviated or unabbreviated forms are accepted. In the `en-US`
2982+locale, locator terms can be written in either singular or plural forms,
2983+as `book`, `bk.`/`bks.`; `chapter`, `chap.`/`chaps.`; `column`,
2984+`col.`/`cols.`; `figure`, `fig.`/`figs.`; `folio`, `fol.`/`fols.`;
2985+`number`, `no.`/`nos.`; `line`, `l.`/`ll.`; `note`, `n.`/`nn.`; `opus`,
2986+`op.`/`opp.`; `page`, `p.`/`pp.`; `paragraph`, `para.`/`paras.`; `part`,
2987+`pt.`/`pts.`; `section`, `sec.`/`secs.`; `sub verbo`, `s.v.`/`s.vv.`;
2988+`verse`, `v.`/`vv.`; `volume`, `vol.`/`vols.`; `¶`/`¶¶`; `§`/`§§`. If no
2989+locator term is used, "page" is assumed.
29692990
29702991A minus sign (`-`) before the `@` will suppress mention of
29712992the author in the citation. This can be useful when the