@@ -1,14 +1,14 @@
1−% Pandoc User's Guide
2−% John MacFarlane
3−% July 6, 2019
1+---
2+title: Pandoc User's Guide
3+author: John MacFarlane
4+date: September 29, 2019
5+---
46
5−Synopsis
6−========
7+# Synopsis
78
89`pandoc` [*options*] [*input-file*]...
910
10−Description
11−===========
11+# Description
1212
1313Pandoc is a [Haskell] library for converting from one markup format to
1414another, and a command-line tool that uses this library.
@@ -40,8 +40,7 @@ model. While conversions from pandoc's Markdown to all formats aspire
4040to be perfect, conversions from formats more expressive than pandoc's
4141Markdown can be expected to be lossy.
4242
43−Using pandoc
44−------------
43+## Using pandoc
4544
4645If no *input-files* are specified, input is read from *stdin*.
4746Output goes to *stdout* by default. For output to a file,
@@ -62,8 +61,7 @@ If multiple input files are given, `pandoc` will concatenate them all (with
6261blank lines between them) before parsing. (Use `--file-scope` to parse files
6362individually.)
6463
65−Specifying formats
66−------------------
64+## Specifying formats
6765
6866The format of the input and output can be specified explicitly using
6967command-line options. The input format can be specified using the
@@ -95,8 +93,7 @@ If no input file is specified (so that input comes from *stdin*), or
9593if the input files' extensions are unknown, the input format will
9694be assumed to be Markdown.
9795
98−Character encoding
99−------------------
96+## Character encoding
10097
10198Pandoc uses the UTF-8 character encoding for both input and output.
10299If your local character encoding is not UTF-8, you
@@ -111,8 +108,7 @@ will only be included if you use the `-s/--standalone` option.
111108
112109[`iconv`]: http://www.gnu.org/software/libiconv/
113110
114−Creating a PDF
115−--------------
111+## Creating a PDF
116112
117113To produce a PDF, specify an output file with a `.pdf` extension:
118114
@@ -206,8 +202,7 @@ footnotes in tables).
206202
207203
208204
209−Reading from the Web
210−--------------------
205+## Reading from the Web
211206
212207Instead of an input file, an absolute URI may be given. In this case
213208pandoc will fetch the content using HTTP:
@@ -220,11 +215,9 @@ header when requesting a document from a URL:
220215 pandoc -f html -t markdown --request-header User-Agent:"Mozilla/5.0" \
221216 http://www.fsf.org
222217
223−Options
224−=======
218+# Options
225219
226−General options {.options}
227−---------------
220+## General options {.options}
228221
229222`-f` *FORMAT*, `-r` *FORMAT*, `--from=`*FORMAT*, `--read=`*FORMAT*
230223
@@ -476,8 +469,7 @@ General options {.options}
476469[PowerPoint]: https://en.wikipedia.org/wiki/Microsoft_PowerPoint
477470[Vimwiki]: https://vimwiki.github.io
478471
479−Reader options {.options}
480−--------------
472+## Reader options {.options}
481473
482474`--shift-heading-level-by=`*NUMBER*
483475
@@ -680,8 +672,7 @@ Reader options {.options}
680672[perl]: https://metacpan.org/pod/Pandoc::Filter
681673[JavaScript/node.js]: https://github.com/mvhenderson/pandoc-filter-node
682674
683−General writer options {.options}
684−----------------------
675+## General writer options {.options}
685676
686677`-s`, `--standalone`
687678
@@ -884,8 +875,7 @@ General writer options {.options}
884875 downloaded). If you're behind a proxy, you also need to set
885876 the environment variable `http_proxy` to `http://...`.
886877
887−Options affecting specific writers {.options}
888−----------------------------------
878+## Options affecting specific writers {.options}
889879
890880`--self-contained`
891881
@@ -1255,8 +1245,7 @@ Options affecting specific writers {.options}
12551245[Encoding issue with the listings package]:
12561246 https://en.wikibooks.org/wiki/LaTeX/Source_Code_Listings#Encoding_issue
12571247
1258−Citation rendering {.options}
1259−------------------
1248+## Citation rendering {.options}
12601249
12611250`--bibliography=`*FILE*
12621251
@@ -1295,8 +1284,7 @@ Citation rendering {.options}
12951284 with the `pandoc-citeproc` filter or with PDF output. It is intended for
12961285 use in producing a LaTeX file that can be processed with [`bibtex`] or [`biber`].
12971286
1298−Math rendering in HTML {.options}
1299−----------------------
1287+## Math rendering in HTML {.options}
13001288
13011289The default is to render TeX math as far as possible using Unicode characters.
13021290Formulas are put inside a `span` with `class="math"`, so that they may be styled
@@ -1356,8 +1344,7 @@ of the following options.
13561344[KaTeX]: https://github.com/Khan/KaTeX
13571345[GladTeX]: http://humenda.github.io/GladTeX/
13581346
1359−Options for wrapper scripts {.options}
1360−---------------------------
1347+## Options for wrapper scripts {.options}
13611348
13621349`--dump-args`
13631350
@@ -1381,8 +1368,7 @@ Options for wrapper scripts {.options}
13811368
13821369 pandoc -o foo.html -s
13831370
1384−Exit codes
1385−==========
1371+# Exit codes
13861372
13871373If pandoc completes successfully, it will return exit code 0.
13881374Nonzero exit codes have the following meanings:
@@ -1411,8 +1397,7 @@ Nonzero exit codes have the following meanings:
14111397 97 PandocCouldNotFindDataFileError
14121398 99 PandocResourceNotFound
14131399
1414−Templates
1415−=========
1400+# Templates
14161401
14171402When the `-s/--standalone` option is used, pandoc uses a template to
14181403add header and footer material that is needed for a self-standing
@@ -1451,8 +1436,7 @@ changes after each pandoc release.
14511436
14521437 [pandoc-templates]: https://github.com/jgm/pandoc-templates
14531438
1454−Template syntax
1455−---------------
1439+## Template syntax
14561440
14571441To mark variables and control structures in the template, either
14581442`$`...`$` or `${`...`}` may be used as delimiters. The styles
@@ -1701,8 +1685,7 @@ $endfor$
17011685```
17021686
17031687
1704−Metadata variables
1705−------------------
1688+## Metadata variables
17061689
17071690`title`, `author`, `date`
17081691: allow identification of basic aspects of the document. Included
@@ -1767,8 +1750,7 @@ will include `title`, `author` and `description` as standard document
17671750properties and `subtitle` as a custom property when converting to docx,
17681751ODT or pptx.
17691752
1770−Language variables
1771−------------------
1753+## Language variables
17721754
17731755`lang`
17741756: identifies the main language of the document using IETF language
@@ -1810,8 +1792,7 @@ Language variables
18101792[Unicode Bidirectional Algorithm]: http://www.w3.org/International/articles/inline-bidi-markup/uba-basics
18111793[Language subtag lookup]: https://r12a.github.io/app-subtags/
18121794
1813−Variables for HTML slides
1814−-------------------------
1795+## Variables for HTML slides
18151796
18161797These affect HTML output when [producing slide shows with pandoc].
18171798
@@ -1833,8 +1814,7 @@ To turn off boolean flags that default to true in reveal.js, use `0`.
18331814
18341815[reveal.js configuration options]: https://github.com/hakimel/reveal.js#configuration
18351816
1836−Variables for Beamer slides
1837−---------------------------
1817+## Variables for Beamer slides
18381818
18391819These variables change the appearance of PDF slides using [`beamer`].
18401820
@@ -1871,8 +1851,7 @@ These variables change the appearance of PDF slides using [`beamer`].
18711851`titlegraphic`
18721852: image for title slide
18731853
1874−Variables for PowerPoint slide shows
1875−--------------------------------------
1854+## Variables for PowerPoint slide shows
18761855
18771856These variables control the visual aspects of a slide show that are not easily
18781857controled via templates.
@@ -1880,8 +1859,7 @@ controled via templates.
18801859`monofont`
18811860: font to use for code.
18821861
1883−Variables for LaTeX
1884−-------------------
1862+## Variables for LaTeX
18851863
18861864Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
18871865
@@ -2064,8 +2042,7 @@ These variables function when using BibLaTeX for [citation rendering].
20642042[`memoir`]: https://ctan.org/pkg/memoir
20652043[`report`]: https://ctan.org/pkg/report
20662044
2067−Variables for ConTeXt
2068−---------------------
2045+## Variables for ConTeXt
20692046
20702047Pandoc uses these variables when [creating a PDF] with ConTeXt.
20712048
@@ -2157,8 +2134,7 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
21572134[`setupinterlinespace`]: https://wiki.contextgarden.net/Command/setupinterlinespace
21582135[`setuppagenumbering`]: https://wiki.contextgarden.net/Command/setuppagenumbering
21592136
2160−Variables for `wkhtmltopdf`
2161−---------------------------
2137+## Variables for `wkhtmltopdf`
21622138
21632139Pandoc uses these variables when [creating a PDF] with [`wkhtmltopdf`].
21642140The `--css` option also affects the output.
@@ -2172,8 +2148,7 @@ The `--css` option also affects the output.
21722148`papersize`
21732149: sets the PDF paper size
21742150
2175−Variables for man pages
2176−-----------------------
2151+## Variables for man pages
21772152
21782153`adjusting`
21792154: adjusts text to left (`l`), right (`r`), center (`c`),
@@ -2191,8 +2166,7 @@ Variables for man pages
21912166`section`
21922167: section number in man pages
21932168
2194−Variables for ms
2195−----------------
2169+## Variables for ms
21962170
21972171`fontfamily`
21982172: font family (e.g. `T` or `P`)
@@ -2206,8 +2180,7 @@ Variables for ms
22062180`pointsize`
22072181: point size (e.g. `10p`)
22082182
2209−Structural variables
2210−--------------------
2183+## Structural variables
22112184
22122185Pandoc sets these variables automatically in response to [options] or
22132186document contents; users can also modify them. These vary depending
@@ -2275,8 +2248,7 @@ on the output format, and include the following:
22752248
22762249[pandoc-templates]: https://github.com/jgm/pandoc-templates
22772250
2278−Extensions
2279−==========
2251+# Extensions
22802252
22812253The behavior of some of the readers and writers can be adjusted by
22822254enabling or disabling various extensions.
@@ -2297,8 +2269,7 @@ Note that markdown extensions added to the `ipynb` format
22972269affect Markdown cells in Jupyter notebooks (as do command-line
22982270options like `--atx-headers`).
22992271
2300−Typography
2301−----------
2272+## Typography
23022273
23032274#### Extension: `smart` ####
23042275
@@ -2330,8 +2301,7 @@ literally. In writing LaTeX, enabling `smart` tells pandoc
23302301to use the ligatures when possible; if `smart` is disabled
23312302pandoc will use unicode quotation mark and dash characters.
23322303
2333−Headings and sections
2334−---------------------
2304+## Headings and sections
23352305
23362306#### Extension: `auto_identifiers` ####
23372307
@@ -2413,8 +2383,7 @@ GitHub's method. Spaces are converted to dashes (`-`),
24132383uppercase characters to lowercase characters, and punctuation
24142384characters other than `-` and `_` are removed.
24152385
2416−Math Input
2417−----------
2386+## Math Input
24182387
24192388The extensions [`tex_math_dollars`](#extension-tex_math_dollars),
24202389[`tex_math_single_backslash`](#extension-tex_math_single_backslash), and
@@ -2424,8 +2393,7 @@ are described in the section about Pandoc's Markdown.
24242393However, they can also be used with HTML input. This is handy for
24252394reading web pages formatted using MathJax, for example.
24262395
2427−Raw HTML/TeX
2428−------------
2396+## Raw HTML/TeX
24292397
24302398The following extensions (especially how they affect Markdown
24312399input/output) are also described in more detail in their respective
@@ -2475,8 +2443,7 @@ When converting HTML to Markdown, for example, you may want to drop all
24752443Analogous to `native_divs` above.
24762444
24772445
2478−Literate Haskell support
2479−------------------------
2446+## Literate Haskell support
24802447
24812448#### Extension: `literate_haskell` ####
24822449
@@ -2537,8 +2504,7 @@ Note that GHC expects the bird tracks in the first column, so indented
25372504literate code blocks (e.g. inside an itemized environment) will not be
25382505picked up by the Haskell compiler.
25392506
2540−Other extensions
2541−----------------
2507+## Other extensions
25422508
25432509#### Extension: `empty_paragraphs` ####
25442510
@@ -2593,8 +2559,7 @@ Natural tables allow more fine-grained global customization but come
25932559at a performance penalty compared to extreme tables.
25942560
25952561
2596−Pandoc's Markdown
2597−=================
2562+# Pandoc's Markdown
25982563
25992564Pandoc understands an extended and slightly revised version of
26002565John Gruber's [Markdown] syntax. This document explains the syntax,
@@ -2604,8 +2569,7 @@ of `markdown`. Extensions can be enabled or disabled to specify the
26042569behavior more granularly. They are described in the following. See also
26052570[Extensions] above, for extensions that work also on other formats.
26062571
2607−Philosophy
2608−----------
2572+## Philosophy
26092573
26102574Markdown is designed to be easy to write, and, even more importantly,
26112575easy to read:
@@ -2626,8 +2590,7 @@ it discourages it, and provides other, non-HTMLish ways of representing
26262590important document elements like definition lists, tables, mathematics, and
26272591footnotes.
26282592
2629−Paragraphs
2630−----------
2593+## Paragraphs
26312594
26322595A paragraph is one or more lines of text followed by one or more blank lines.
26332596Newlines are treated as spaces, so you can reflow your paragraphs as you like.
@@ -2640,8 +2603,7 @@ Note: in multiline and grid table cells, this is the only way
26402603to create a hard line break, since trailing spaces in the cells
26412604are ignored.
26422605
2643−Headings
2644−--------
2606+## Headings
26452607
26462608There are two kinds of headings: Setext and ATX.
26472609
@@ -2772,8 +2734,7 @@ link will point to `bar`, not to `#foo`:
27722734
27732735 See [foo]
27742736
2775−Block quotations
2776−----------------
2737+## Block quotations
27772738
27782739Markdown uses email conventions for quoting blocks of text.
27792740A block quotation is one or more paragraphs or other block elements
@@ -2823,8 +2784,7 @@ not produce a nested block quote in pandoc:
28232784 >> Nested.
28242785
28252786
2826−Verbatim (code) blocks
2827−----------------------
2787+## Verbatim (code) blocks
28282788
28292789### Indented code blocks ###
28302790
@@ -2930,8 +2890,7 @@ To set the highlighting style, use `--highlight-style`.
29302890For more information on highlighting, see [Syntax highlighting],
29312891below.
29322892
2933−Line blocks
2934−-----------
2893+## Line blocks
29352894
29362895#### Extension: `line_blocks` ####
29372896
@@ -2959,8 +2918,7 @@ line must begin with a space.
29592918
29602919This syntax is borrowed from [reStructuredText].
29612920
2962−Lists
2963−-----
2921+## Lists
29642922
29652923### Bullet lists ###
29662924
@@ -3291,8 +3249,7 @@ of one big list:
32913249 2. dos
32923250 3. tres
32933251
3294−Horizontal rules
3295−----------------
3252+## Horizontal rules
32963253
32973254A line containing a row of three or more `*`, `-`, or `_` characters
32983255(optionally separated by spaces) produces a horizontal rule:
@@ -3302,8 +3259,7 @@ A line containing a row of three or more `*`, `-`, or `_` characters
33023259 ---------------
33033260
33043261
3305−Tables
3306−------
3262+## Tables
33073263
33083264Four kinds of tables may be used. The first three kinds presuppose the use of
33093265a fixed-width font, such as Courier. The fourth kind can be used with
@@ -3517,8 +3473,7 @@ you'll need to add colons as above.
35173473
35183474[PHP Markdown Extra tables]: https://michelf.ca/projects/php-markdown/extra/#table
35193475
3520−Metadata blocks
3521−---------------
3476+## Metadata blocks
35223477
35233478#### Extension: `pandoc_title_block` ####
35243479
@@ -3694,8 +3649,7 @@ will be interpreted as markdown. For example:
36943649 \renewcommand{\section}[1]{\clearpage\oldsection{#1}}
36953650 ```
36963651
3697−Backslash escapes
3698−-----------------
3652+## Backslash escapes
36993653
37003654#### Extension: `all_symbols_escapable` ####
37013655
@@ -3733,8 +3687,7 @@ two trailing spaces on a line.
37333687
37343688Backslash escapes do not work in verbatim contexts.
37353689
3736−Inline formatting
3737−-----------------
3690+## Inline formatting
37383691
37393692### Emphasis ###
37403693
@@ -3836,8 +3789,7 @@ For compatibility with other Markdown flavors, CSS is also supported:
38363789This will work in all output formats that support small caps.
38373790
38383791
3839−Math
3840−----
3792+## Math
38413793
38423794#### Extension: `tex_math_dollars` ####
38433795
@@ -3912,8 +3864,7 @@ HTML, Slidy, DZSlides, S5, EPUB
39123864
39133865[interpreted text role `:math:`]: http://docutils.sourceforge.net/docs/ref/rst/roles.html#math
39143866
3915−Raw HTML
3916−--------
3867+## Raw HTML
39173868
39183869#### Extension: `raw_html` ####
39193870
@@ -4059,8 +4010,7 @@ example, to use a raw attribute with a backtick code block,
40594010
40604011The raw attribute cannot be combined with regular attributes.
40614012
4062−LaTeX macros
4063−------------
4013+## LaTeX macros
40644014
40654015#### Extension: `latex_macros` ####
40664016
@@ -4084,8 +4034,7 @@ you are targeting LaTeX or PDF.
40844034Whether or not `latex_macros` is enabled, the macro definitions
40854035will still be passed through as raw LaTeX.
40864036
4087−Links
4088−-----
4037+## Links
40894038
40904039Markdown allows links to be specified in several ways.
40914040
@@ -4193,8 +4142,7 @@ or
41934142Internal links are currently supported for HTML formats (including
41944143HTML slide shows and EPUB), LaTeX, and ConTeXt.
41954144
4196−Images
4197−------
4145+## Images
41984146
41994147A link immediately preceded by a `!` will be treated as an image.
42004148The link text will be used as the image's alt text:
@@ -4274,8 +4222,7 @@ For example:
42744222 is to look at the image resolution and the dpi metadata embedded in
42754223 the image file.
42764224
4277−Divs and Spans
4278−--------------
4225+## Divs and Spans
42794226
42804227Using the `native_divs` and `native_spans` extensions
42814228(see [above][Extension: `native_divs`]), HTML syntax can
@@ -4331,8 +4278,7 @@ followed immediately by attributes:
43314278
43324279 [This is *some text*]{.class key="val"}
43334280
4334−Footnotes
4335−---------
4281+## Footnotes
43364282
43374283#### Extension: `footnotes` ####
43384284
@@ -4378,8 +4324,7 @@ they cannot contain multiple paragraphs). The syntax is as follows:
43784324
43794325Inline and regular footnotes may be mixed freely.
43804326
4381−Citations
4382−---------
4327+## Citations
43834328
43844329#### Extension: `citations` ####
43854330
@@ -4591,8 +4536,7 @@ For more information, see the [pandoc-citeproc man page].
45914536[CSL locale files]: https://github.com/citation-style-language/locales
45924537[pandoc-citeproc man page]: https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md
45934538
4594−Non-pandoc extensions
4595−---------------------
4539+## Non-pandoc extensions
45964540
45974541The following Markdown syntax extensions are not enabled by default
45984542in pandoc, but may be enabled by adding `+EXTENSION` to the format
@@ -4754,8 +4698,7 @@ for regular emphasis, add extra blank space around headings.
47544698
47554699 [Project Gutenberg]: https://www.gutenberg.org
47564700
4757−Markdown variants
4758−-----------------
4701+## Markdown variants
47594702
47604703In addition to pandoc's extended Markdown, the following Markdown
47614704variants are supported:
@@ -4806,8 +4749,7 @@ only affects `gfm` output, not input.
48064749 `lists_without_preceding_blankline`.
48074750
48084751
4809−Producing slide shows with pandoc
4810−=================================
4752+# Producing slide shows with pandoc
48114753
48124754You can use pandoc to produce an HTML + JavaScript slide presentation
48134755that can be viewed via a web browser. There are five ways to do this,
@@ -4879,8 +4821,7 @@ To produce a Powerpoint slide show, type
48794821
48804822 pandoc habits.txt -o habits.pptx
48814823
4882−Structuring the slide show
4883−--------------------------
4824+## Structuring the slide show
48844825
48854826By default, the *slide level* is the highest heading level in
48864827the hierarchy that is followed immediately by content, and not another
@@ -4921,8 +4862,7 @@ layout will be produced, with level-1 headings building horizontally
49214862and level-2 headings building vertically. It is not recommended that
49224863you use deeper nesting of section levels with reveal.js.
49234864
4924−Incremental lists
4925−-----------------
4865+## Incremental lists
49264866
49274867By default, these writers produce lists that display "all at once."
49284868If you want your lists to display incrementally (one item at a time),
@@ -4963,8 +4903,7 @@ in a single document.
49634903Note: Neither the `-i/--incremental` option nor any of the
49644904methods described here currently works for PowerPoint output.
49654905
4966−Inserting pauses
4967−----------------
4906+## Inserting pauses
49684907
49694908You can add "pauses" within a slide by including a paragraph containing
49704909three dots, separated by spaces:
@@ -4979,8 +4918,7 @@ three dots, separated by spaces:
49794918
49804919Note: this feature is not yet implemented for PowerPoint output.
49814920
4982−Styling the slides
4983−------------------
4921+## Styling the slides
49844922
49854923You can change the style of HTML slides by putting customized CSS files
49864924in `$DATADIR/s5/default` (for S5), `$DATADIR/slidy` (for Slidy),
@@ -5015,8 +4953,7 @@ bibliographies:
50154953
50164954 # References {.allowframebreaks}
50174955
5018−Speaker notes
5019−-------------
4956+## Speaker notes
50204957
50214958Speaker notes are supported in reveal.js and PowerPoint (pptx)
50224959output. You can add notes to your Markdown document thus:
@@ -5037,8 +4974,7 @@ in handouts and presenter view.
50374974Notes are not yet supported for other slide formats, but the notes
50384975will not appear on the slides themselves.
50394976
5040−Columns
5041−-------
4977+## Columns
50424978
50434979To put material in side by side columns, you can use a native
50444980div container with class `columns`, containing two or more div
@@ -5053,8 +4989,7 @@ containers with class `column` and a `width` attribute:
50534989 :::
50544990 ::::::::::::::
50554991
5056−Frame attributes in beamer
5057−--------------------------
4992+## Frame attributes in beamer
50584993
50594994Sometimes it is necessary to add the LaTeX `[fragile]` option to
50604995a frame in beamer (for example, when using the `minted` environment).
@@ -5068,8 +5003,7 @@ the [Beamer User's Guide] may also be used: `allowdisplaybreaks`,
50685003`allowframebreaks`, `b`, `c`, `t`, `environment`, `label`, `plain`,
50695004`shrink`, `standout`, `noframenumbering`.
50705005
5071−Background in reveal.js and beamer
5072−----------------------------------
5006+## Background in reveal.js and beamer
50735007
50745008Background images can be added to self-contained reveal.js slideshows and
50755009to beamer slideshows.
@@ -5116,11 +5050,9 @@ Slide 1 has background_image.png as its background.
51165050Slide 2 has a special image for its background, even though the heading has no content.
51175051```
51185052
5119−Creating EPUBs with pandoc
5120−==========================
5053+# Creating EPUBs with pandoc
51215054
5122−EPUB Metadata
5123−-------------
5055+## EPUB Metadata
51245056
51255057EPUB metadata may be specified using the `--epub-metadata` option, but
51265058if the source document is Markdown, it is better to use a [YAML metadata
@@ -5222,8 +5154,7 @@ The following fields are recognized:
52225154[MARC relators]: http://loc.gov/marc/relators/relaterm.html
52235155[`spine` element]: http://idpf.org/epub/301/spec/epub-publications.html#sec-spine-elem
52245156
5225−The `epub:type` attribute
5226−-------------------------
5157+## The `epub:type` attribute
52275158
52285159For `epub3` output, you can mark up the heading that corresponds to an EPUB
52295160chapter using the [`epub:type` attribute][epub-type]. For example, to set
@@ -5269,8 +5200,7 @@ index backmatter
52695200
52705201[epub-type]: http://www.idpf.org/epub/31/spec/epub-contentdocs.html#sec-epub-type-attribute
52715202
5272−Linked media
5273−------------
5203+## Linked media
52745204
52755205By default, pandoc will download media referenced from any `<img>`, `<audio>`,
52765206`<video>` or `<source>` element present in the generated EPUB,
@@ -5285,8 +5215,7 @@ with the `src` attribute. For example:
52855215 </source>
52865216 </audio>
52875217
5288−Creating Jupyter notebooks with pandoc
5289−======================================
5218+# Creating Jupyter notebooks with pandoc
52905219
52915220When creating a [Jupyter notebook], pandoc will try to infer the
52925221notebook structure. Code blocks with the class `code` will be
@@ -5411,8 +5340,7 @@ soft line breaks in Markdown cells; `--atx-headers` will
54115340cause ATX-style headings to be used; and `--preserve-tabs` will
54125341prevent tabs from being turned to spaces.
54135342
5414−Syntax highlighting
5415−===================
5343+# Syntax highlighting
54165344
54175345Pandoc will automatically highlight syntax in [fenced code blocks] that
54185346are marked with a language name. The Haskell library [skylighting] is
@@ -5448,13 +5376,11 @@ To disable highlighting, use the `--no-highlight` option.
54485376
54495377[skylighting]: https://github.com/jgm/skylighting
54505378
5451−Custom Styles
5452−=============
5379+# Custom Styles
54535380
54545381Custom styles can be used in the docx and ICML formats.
54555382
5456−Output
5457−------
5383+## Output
54585384
54595385By default, pandoc's docx and ICML output applies a predefined set of styles
54605386for blocks such as paragraphs and block quotes, and uses largely default
@@ -5501,8 +5427,7 @@ custom styles to work.
55015427
55025428[pandoc filters]: http://pandoc.org/filters.html
55035429
5504−Input
5505−-----
5430+## Input
55065431
55075432The docx reader, by default, only reads those styles that it can
55085433convert into pandoc elements, either by direct conversion or
@@ -5549,8 +5474,7 @@ With these custom styles, you can use your input document as a
55495474reference-doc while creating docx output (see below), and maintain the
55505475same styles in your input and output files.
55515476
5552−Custom writers
5553−==============
5477+# Custom writers
55545478
55555479Pandoc can be extended with custom writers written in [lua]. (Pandoc
55565480includes a lua interpreter, so lua need not be installed separately.)
@@ -5568,8 +5492,7 @@ which you can modify according to your needs, do
55685492
55695493[lua]: http://www.lua.org
55705494
5571−A note on security
5572−==================
5495+# A note on security
55735496
55745497If you use pandoc to convert user-contributed content in a web
55755498application, here are some things to keep in mind:
@@ -5601,8 +5524,7 @@ application, here are some things to keep in mind:
56015524 headings, spans, and code blocks. To be safe, you should
56025525 run all the generated HTML through an HTML sanitizer.
56035526
5604−Authors
5605−=======
5527+# Authors
56065528
56075529Copyright 2006--2019 John MacFarlane (jgm@berkeley.edu). Released
56085530under the [GPL], version 2 or greater. This software carries no