7120df9 · typeable/pandoc

25superscript, subscript, strikeout, title blocks, automatic tables of

26contents, embedded LaTeX math, citations, and markdown inside HTML block

27elements.

28−(These enhancements, described below under PANDOC\[aq]S MARKDOWN, can be

28+(These enhancements, described below under Pandoc\[aq]s markdown, can be

29disabled using the \f[C]markdown_strict\f[] input or output format.)

30.PP

31In contrast to most existing tools for converting markdown to HTML,

64.fi

65.PP

66For more information on how standalone documents are produced, see

67−TEMPLATES, below.

67+Templates, below.

68.PP

69Instead of a file, an absolute URI may be given.

70In this case pandoc will fetch the content using HTTP:

200(Haddock markup), or \f[C]latex\f[] (LaTeX).

201If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],

202\f[C]latex\f[], or \f[C]html\f[], the input will be treated as literate

203−Haskell source: see LITERATE HASKELL SUPPORT, below.

203+Haskell source: see Literate Haskell support, below.

204Markdown syntax extensions can be individually enabled or disabled by

205appending \f[C]+EXTENSION\f[] or \f[C]\-EXTENSION\f[] to the format

206name.

208strict markdown with footnotes and definition lists enabled, and

209\f[C]markdown\-pipe_tables+hard_line_breaks\f[] is pandoc\[aq]s markdown

210without pipe tables and with hard line breaks.

211−See PANDOC\[aq]S MARKDOWN, below, for a list of extensions and their

211+See Pandoc\[aq]s markdown, below, for a list of extensions and their

212names.

213.RS

214.RE

237show), \f[C]dzslides\f[] (DZSlides HTML5 + javascript slide show),

238\f[C]revealjs\f[] (reveal.js HTML5 + javascript slide show), \f[C]s5\f[]

239(S5 HTML and javascript slide show), or the path of a custom lua writer

240−(see CUSTOM WRITERS, below).

240+(see Custom writers, below).

241Note that \f[C]odt\f[], \f[C]epub\f[], and \f[C]epub3\f[] output will

242not be directed to \f[I]stdout\f[]; an output filename must be specified

243using the \f[C]\-o/\-\-output\f[] option.

244If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],

245\f[C]latex\f[], \f[C]beamer\f[], \f[C]html\f[], or \f[C]html5\f[], the

246−output will be rendered as literate Haskell source: see LITERATE HASKELL

246+output will be rendered as literate Haskell source: see Literate Haskell

247−SUPPORT, below.

247+support, below.

248Markdown syntax extensions can be individually enabled or disabled by

249appending \f[C]+EXTENSION\f[] or \f[C]\-EXTENSION\f[] to the format

250name, as described above under \f[C]\-f\f[].

482.B \f[C]\-\-template=\f[]\f[I]FILE\f[]

483Use \f[I]FILE\f[] as a custom template for the generated document.

484Implies \f[C]\-\-standalone\f[].

485−See TEMPLATES below for a description of template syntax.

485+See Templates below for a description of template syntax.

486If no extension is specified, an extension corresponding to the writer

487will be added, so that \f[C]\-\-template=special\f[] looks for

488\f[C]special.html\f[] for HTML output.

559Options are \f[C]pygments\f[] (the default), \f[C]kate\f[],

560\f[C]monochrome\f[], \f[C]espresso\f[], \f[C]zenburn\f[],

561\f[C]haddock\f[], and \f[C]tango\f[].

562−For more information on syntax highlighting in pandoc, see SYNTAX

562+For more information on syntax highlighting in pandoc, see Syntax

563−HIGHLIGHTING, below.

563+highlighting, below.

564.RS

565.RE

566.TP

722show into sections; headers below this level create subheads within a

723slide.

724The default is to set the slide level based on the contents of the

725−document; see STRUCTURING THE SLIDE SHOW, below.

725+document; see Structuring the slide show, below.

726.RS

727.RE

728.TP

730Wrap sections in \f[C]<div>\f[] tags (or \f[C]<section>\f[] tags in

731HTML5), and attach identifiers to the enclosing \f[C]<div>\f[] (or

732\f[C]<section>\f[]) rather than the header itself.

733−See SECTION IDENTIFIERS, below.

733+See Header identifiers, below.

734.RS

735.RE

736.TP

814It is recommended that the image be less than 1000px in width and

815height.

816Note that in a markdown source document you can also specify

817−\f[C]cover\-image\f[] in a YAML metadata block (see EPUB METADATA,

817+\f[C]cover\-image\f[] in a YAML metadata block (see EPUB Metadata,

818below).

819.RS

820.RE

843.PP

844Note: if the source document is markdown, a YAML metadata block in the

845document can be used instead.

846−See below under EPUB METADATA.

846+See below under EPUB Metadata.

847.RE

848.TP

849.B \f[C]\-\-epub\-embed\-font=\f[]\f[I]FILE\f[]

1453.fi

1454.PP

1455The header text can contain inline formatting, such as emphasis (see

1456−INLINE FORMATTING, below).

1456+Inline formatting, below).

1457.SS Atx\-style headers

1458.PP

1459An Atx\-style header consists of one to six \f[C]#\f[] signs and a line

1492#22,\ for\ example,\ and\ #5.

1493\f[]

1494.fi

1495−.SS Header identifiers in HTML, LaTeX, and ConTeXt

1495+.SS Header identifiers

1496.SS Extension: \f[C]header_attributes\f[]

1497.PP

1498Headers can be assigned attributes using this syntax at the end of the

1876.PP

1877To prevent all highlighting, use the \f[C]\-\-no\-highlight\f[] flag.

1878To set the highlighting style, use \f[C]\-\-highlight\-style\f[].

1879−For more information on highlighting, see SYNTAX HIGHLIGHTING, below.

1879+For more information on highlighting, see Syntax highlighting, below.

1880.SS Line blocks

1881.SS Extension: \f[C]line_blocks\f[]

1882.PP

2191Note that space between items in a definition list is required.

2192(A variant that loosens this requirement, but disallows "lazy" hard

2193wrapping, can be activated with \f[C]compact_definition_lists\f[]: see

2194−NON\-PANDOC EXTENSIONS, below.)

2194+Non\-pandoc extensions, below.)

2195.SS Numbered example lists

2196.SS Extension: \f[C]example_lists\f[]

2197.PP

2911.fi

2912.SS Extension: \f[C]inline_code_attributes\f[]

2913.PP

2914−Attributes can be attached to verbatim text, just as with FENCED CODE

2914+Attributes can be attached to verbatim text, just as with fenced code

2915−BLOCKS:

2915+blocks:

2916.IP

2917.nf

2918\f[C]

3323.SS Internal links

3324.PP

3325To link to another section of the same document, use the automatically

3326−generated identifier (see HEADER IDENTIFIERS IN HTML, LATEX, AND

3326+generated identifier (see Header identifiers, below).

3327−CONTEXT, below).

3328For example:

3327For example:

3329.IP

3328.IP

3330.nf

3329.nf

3758.SS Extension: \f[C]compact_definition_lists\f[]

3757.SS Extension: \f[C]compact_definition_lists\f[]

3759.PP

3758.PP

3760Activates the definition list syntax of pandoc 1.12.x and earlier.

3759Activates the definition list syntax of pandoc 1.12.x and earlier.

3761−This syntax differs from the one described ABOVE in several respects:

3760+This syntax differs from the one described above in several respects:

3762.IP \[bu] 2

3761.IP \[bu] 2

3763No blank line is required between consecutive items of the definition

3762No blank line is required between consecutive items of the definition

3764list.

3763list.