Options
Note that if you are producing a PDF via
ms
, the table of contents will appear at the
beginning of the document, before the title. If you would prefer it to be at the end of
the document, use the option --pdf-engine-opt=--no-toc-relocation.
--toc-depth=NUMBER
Specify the number of section levels to include in the table of con-
tents. The default is 3 (which means that level-1, 2, and 3 headings will be listed in the
contents).
--strip-comments[=true|false]
Strip out HTML comments in the Markdown or Textile
source, rather than passing them on to Markdown, Textile or HTML output as raw
HTML. This does not apply to HTML comments inside raw HTML blocks when the
markdown_in_html_blocks extension is not set.
--no-highlight
Disables syntax highlighting for code blocks and inlines, even when a
language attribute is given.
--highlight-style=STYLE|FILE
Specifies the coloring style to be used in highlighted
source code. Options are
pygments
(the default),
kate
,
monochrome
,
breezeDark
,
espresso
,
zenburn
,
haddock
, and
tango
. For more information on syntax highlighting
in pandoc, see Syntax highlighting, below. See also --list-highlight-styles.
Instead of a STYLE name, a JSON file with extension
.theme
may be supplied. This will
be parsed as a KDE syntax highlighting theme and (if valid) used as the highlighting
style.
To generate the JSON version of an existing style, use --print-highlight-style.
--print-highlight-style=STYLE|FILE
Prints a JSON version of a highlighting style,
which can be modified, saved with a
.theme
extension, and used with
--highlight-
style
. This option may be used with
-o
/
--output
to redirect output to a file, but
-o/--output must come before --print-highlight-style on the command line.
--syntax-definition=FILE
Instructs pandoc to load a KDE XML syntax definition file,
which will be used for syntax highlighting of appropriately marked code blocks. This
can be used to add support for new languages or to use altered syntax definitions for
existing languages. This option may be repeated to add multiple syntax definitions.
-H FILE, --include-in-header=FILE|URL
Include contents of FILE, verbatim, at the end of
the header. This can be used, for example, to include special CSS or JavaScript in
HTML documents. This option can be used repeatedly to include multiple files in the
header. They will be included in the order specified. Implies --standalone.
-B FILE, --include-before-body=FILE|URL
Include contents of FILE, verbatim, at the
beginning of the document body (e.g. after the
<body>
tag in HTML, or the
\begin{document}
command in LaTeX). This can be used to include navigation bars
or banners in HTML documents. This option can be used repeatedly to include
multiple files. They will be included in the order specified. Implies
--standalone
.
Note that if the output format is
odt
, this file must be in OpenDocument XML format
16