@@ -1,5 +1,5 @@
2−.TH PANDOC 1 "January 29, 2017" "pandoc 1.19.2"
2+.TH PANDOC 1 "March 26, 2017" "pandoc 2.0"
4pandoc - general markup converter
4pandoc - general markup converter
5.SH SYNOPSIS
5.SH SYNOPSIS
@@ -18,10 +18,11 @@ Markdown, MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX
18(including \f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook,
18(including \f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook,
19OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki
19OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki
20markup, ZimWiki markup, Haddock markup, EPUB (v2 or v3), FictionBook2,
20markup, ZimWiki markup, Haddock markup, EPUB (v2 or v3), FictionBook2,
21−Textile, groff man pages, Emacs Org mode, AsciiDoc, InDesign ICML, TEI
21+Textile, groff man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML,
22−Simple, and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide shows.
22+TEI Simple, and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide
23−It can also produce PDF output on systems where LaTeX, ConTeXt, or
24+It can also produce PDF output on systems where LaTeX, ConTeXt,
24−\f[C]wkhtmltopdf\f[] is installed.
25+\f[C]pdfroff\f[], or \f[C]wkhtmltopdf\f[] is installed.
26Pandoc's enhanced version of Markdown includes syntax for footnotes,
27Pandoc's enhanced version of Markdown includes syntax for footnotes,
27tables, flexible ordered lists, definition lists, fenced code blocks,
28tables, flexible ordered lists, definition lists, fenced code blocks,
@@ -57,7 +58,7 @@ Otherwise, the \f[I]input\-files\f[] are concatenated (with a blank line
57between each) and used as input.
58between each) and used as input.
58Output goes to \f[I]stdout\f[] by default (though output to
59Output goes to \f[I]stdout\f[] by default (though output to
59\f[I]stdout\f[] is disabled for the \f[C]odt\f[], \f[C]docx\f[],
60\f[I]stdout\f[] is disabled for the \f[C]odt\f[], \f[C]docx\f[],
60−\f[C]epub\f[], and \f[C]epub3\f[] output formats).
61+\f[C]epub2\f[], and \f[C]epub3\f[] output formats).
61For output to a file, use the \f[C]\-o\f[] option:
62For output to a file, use the \f[C]\-o\f[] option:
@@ -89,6 +90,15 @@ pandoc\ \-f\ html\ \-t\ markdown\ http://www.fsf.org
93+It is possible to supply a custom User\-Agent string when requesting a
94+document from a URL, by setting an environment variable:
98+USER_AGENT="Mozilla/5.0"\ pandoc\ \-f\ html\ \-t\ markdown\ http://www.fsf.org
92If multiple input files are given, \f[C]pandoc\f[] will concatenate them
102If multiple input files are given, \f[C]pandoc\f[] will concatenate them
93all (with blank lines between them) before parsing.
103all (with blank lines between them) before parsing.
94This feature is disabled for binary input formats such as \f[C]EPUB\f[],
104This feature is disabled for binary input formats such as \f[C]EPUB\f[],
@@ -172,29 +182,32 @@ pandoc\ test.txt\ \-o\ test.pdf
172Production of a PDF requires that a LaTeX engine be installed (see
182Production of a PDF requires that a LaTeX engine be installed (see
173\f[C]\-\-latex\-engine\f[], below), and assumes that the following LaTeX
183\f[C]\-\-latex\-engine\f[], below), and assumes that the following LaTeX
174packages are available: \f[C]amsfonts\f[], \f[C]amsmath\f[],
184packages are available: \f[C]amsfonts\f[], \f[C]amsmath\f[],
185+\f[C]lm\f[], \f[C]unicode\-math\f[], \f[C]ifxetex\f[],
175−\f[C]lm\f[], \f[C]ifxetex\f[], \f[C]ifluatex\f[], \f[C]eurosym\f[],
186+\f[C]ifluatex\f[], \f[C]eurosym\f[], \f[C]listings\f[] (if the
176−\f[C]listings\f[] (if the \f[C]\-\-listings\f[] option is used),
187+\f[C]\-\-listings\f[] option is used), \f[C]fancyvrb\f[],
177−\f[C]fancyvrb\f[], \f[C]longtable\f[], \f[C]booktabs\f[],
188+\f[C]longtable\f[], \f[C]booktabs\f[], \f[C]graphicx\f[] and
178−\f[C]graphicx\f[] and \f[C]grffile\f[] (if the document contains
189+\f[C]grffile\f[] (if the document contains images), \f[C]hyperref\f[],
179−images), \f[C]hyperref\f[], \f[C]ulem\f[], \f[C]geometry\f[] (with the
190+\f[C]ulem\f[], \f[C]geometry\f[] (with the \f[C]geometry\f[] variable
180−\f[C]geometry\f[] variable set), \f[C]setspace\f[] (with
181−\f[C]linestretch\f[]), and \f[C]babel\f[] (with \f[C]lang\f[]).
191+set), \f[C]setspace\f[] (with \f[C]linestretch\f[]), and \f[C]babel\f[]
192+(with \f[C]lang\f[]).
182The use of \f[C]xelatex\f[] or \f[C]lualatex\f[] as the LaTeX engine
193The use of \f[C]xelatex\f[] or \f[C]lualatex\f[] as the LaTeX engine
183−requires \f[C]fontspec\f[]; \f[C]xelatex\f[] uses \f[C]mathspec\f[],
194+requires \f[C]fontspec\f[].
184−\f[C]polyglossia\f[] (with \f[C]lang\f[]), \f[C]xecjk\f[], and
195+\f[C]xelatex\f[] uses \f[C]polyglossia\f[] (with \f[C]lang\f[]),
185−\f[C]bidi\f[] (with the \f[C]dir\f[] variable set).
196+\f[C]xecjk\f[], and \f[C]bidi\f[] (with the \f[C]dir\f[] variable set).
197+If the \f[C]mathspec\f[] variable is set, \f[C]xelatex\f[] will use
198+\f[C]mathspec\f[] instead of \f[C]unicode\-math\f[].
186The \f[C]upquote\f[] and \f[C]microtype\f[] packages are used if
199The \f[C]upquote\f[] and \f[C]microtype\f[] packages are used if
187−available, and \f[C]csquotes\f[] will be used for smart punctuation if
200+available, and \f[C]csquotes\f[] will be used for [smart punctuation] if
188added to the template or included in any header file.
201added to the template or included in any header file.
189The \f[C]natbib\f[], \f[C]biblatex\f[], \f[C]bibtex\f[], and
202The \f[C]natbib\f[], \f[C]biblatex\f[], \f[C]bibtex\f[], and
190\f[C]biber\f[] packages can optionally be used for citation rendering.
203\f[C]biber\f[] packages can optionally be used for citation rendering.
191These are included with all recent versions of TeX Live.
204These are included with all recent versions of TeX Live.
193−Alternatively, pandoc can use ConTeXt or \f[C]wkhtmltopdf\f[] to create
206+Alternatively, pandoc can use ConTeXt, \f[C]wkhtmltopdf\f[], or
194−a PDF.
207+\f[C]pdfroff\f[] to create a PDF.
195To do this, specify an output file with a \f[C]\&.pdf\f[] extension, as
208To do this, specify an output file with a \f[C]\&.pdf\f[] extension, as
196−before, but add \f[C]\-t\ context\f[] or \f[C]\-t\ html5\f[] to the
209+before, but add \f[C]\-t\ context\f[], \f[C]\-t\ html5\f[], or
197−command line.
210+\f[C]\-t\ ms\f[] to the command line.
199PDF output can be controlled using variables for LaTeX (if LaTeX is
212PDF output can be controlled using variables for LaTeX (if LaTeX is
200used) and variables for ConTeXt (if ConTeXt is used).
213used) and variables for ConTeXt (if ConTeXt is used).
@@ -243,18 +256,20 @@ Specify output format.
243(original unextended Markdown), \f[C]markdown_phpextra\f[] (PHP Markdown
256(original unextended Markdown), \f[C]markdown_phpextra\f[] (PHP Markdown
244Extra), \f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
257Extra), \f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
245\f[C]markdown_mmd\f[] (MultiMarkdown), \f[C]commonmark\f[] (CommonMark
258\f[C]markdown_mmd\f[] (MultiMarkdown), \f[C]commonmark\f[] (CommonMark
246−Markdown), \f[C]rst\f[] (reStructuredText), \f[C]html\f[] (XHTML),
259+Markdown), \f[C]rst\f[] (reStructuredText), \f[C]html4\f[] (XHTML 1.0
260+Transitional), \f[C]html\f[] or \f[C]html5\f[] (HTML5/XHTML polyglot
247−\f[C]html5\f[] (HTML5), \f[C]latex\f[] (LaTeX), \f[C]beamer\f[] (LaTeX
261+markup), \f[C]latex\f[] (LaTeX), \f[C]beamer\f[] (LaTeX beamer slide
248−beamer slide show), \f[C]context\f[] (ConTeXt), \f[C]man\f[] (groff
262+show), \f[C]context\f[] (ConTeXt), \f[C]man\f[] (groff man),
249−man), \f[C]mediawiki\f[] (MediaWiki markup), \f[C]dokuwiki\f[] (DokuWiki
263+\f[C]mediawiki\f[] (MediaWiki markup), \f[C]dokuwiki\f[] (DokuWiki
250markup), \f[C]zimwiki\f[] (ZimWiki markup), \f[C]textile\f[] (Textile),
264markup), \f[C]zimwiki\f[] (ZimWiki markup), \f[C]textile\f[] (Textile),
251\f[C]org\f[] (Emacs Org mode), \f[C]texinfo\f[] (GNU Texinfo),
265\f[C]org\f[] (Emacs Org mode), \f[C]texinfo\f[] (GNU Texinfo),
252−\f[C]opml\f[] (OPML), \f[C]docbook\f[] (DocBook 4), \f[C]docbook5\f[]
266+\f[C]opml\f[] (OPML), \f[C]docbook\f[] or \f[C]docbook4\f[] (DocBook 4),
267+\f[C]docbook5\f[] (DocBook 5), \f[C]jats\f[] (JATS XML),
253−(DocBook 5), \f[C]opendocument\f[] (OpenDocument), \f[C]odt\f[]
268+\f[C]opendocument\f[] (OpenDocument), \f[C]odt\f[] (OpenOffice text
254−(OpenOffice text document), \f[C]docx\f[] (Word docx), \f[C]haddock\f[]
269+document), \f[C]docx\f[] (Word docx), \f[C]haddock\f[] (Haddock markup),
255−(Haddock markup), \f[C]rtf\f[] (rich text format), \f[C]epub\f[] (EPUB
270+\f[C]rtf\f[] (rich text format), \f[C]epub2\f[] (EPUB v2 book),
256−v2 book), \f[C]epub3\f[] (EPUB v3), \f[C]fb2\f[] (FictionBook2 e\-book),
271+\f[C]epub\f[] or \f[C]epub3\f[] (EPUB v3), \f[C]fb2\f[] (FictionBook2
257−\f[C]asciidoc\f[] (AsciiDoc), \f[C]icml\f[] (InDesign ICML),
272+e\-book), \f[C]asciidoc\f[] (AsciiDoc), \f[C]icml\f[] (InDesign ICML),
258\f[C]tei\f[] (TEI Simple), \f[C]slidy\f[] (Slidy HTML and JavaScript
273\f[C]tei\f[] (TEI Simple), \f[C]slidy\f[] (Slidy HTML and JavaScript
259slide show), \f[C]slideous\f[] (Slideous HTML and JavaScript slide
274slide show), \f[C]slideous\f[] (Slideous HTML and JavaScript slide
260show), \f[C]dzslides\f[] (DZSlides HTML5 + JavaScript slide show),
275show), \f[C]dzslides\f[] (DZSlides HTML5 + JavaScript slide show),
@@ -265,7 +280,7 @@ Note that \f[C]odt\f[], \f[C]epub\f[], and \f[C]epub3\f[] output will
265not be directed to \f[I]stdout\f[]; an output filename must be specified
280not be directed to \f[I]stdout\f[]; an output filename must be specified
266using the \f[C]\-o/\-\-output\f[] option.
281using the \f[C]\-o/\-\-output\f[] option.
267If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],
282If \f[C]+lhs\f[] is appended to \f[C]markdown\f[], \f[C]rst\f[],
268−\f[C]latex\f[], \f[C]beamer\f[], \f[C]html\f[], or \f[C]html5\f[], the
283+\f[C]latex\f[], \f[C]beamer\f[], \f[C]html4\f[], or \f[C]html5\f[], the
269output will be rendered as literate Haskell source: see Literate Haskell
284output will be rendered as literate Haskell source: see Literate Haskell
270support, below.
285support, below.
271Markdown syntax extensions can be individually enabled or disabled by
286Markdown syntax extensions can be individually enabled or disabled by
@@ -340,6 +355,23 @@ Currently this only has an effect with PDF output.
358+.B \f[C]\-\-quiet\f[]
359+Suppress warning messages.
363+.B \f[C]\-\-fail\-if\-warnings\f[]
364+Exit with error status if there are any warnings.
368+.B \f[C]\-\-log=\f[]\f[I]FILE\f[]
369+Write log messages in machine\-readable JSON format to \f[I]FILE\f[].
370+All messages above DEBUG level will be written, regardless of verbosity
371+settings (\f[C]\-\-verbose\f[], \f[C]\-\-quiet\f[]).
343.B \f[C]\-\-list\-input\-formats\f[]
375.B \f[C]\-\-list\-input\-formats\f[]
344List supported input formats, one per line.
376List supported input formats, one per line.
@@ -379,41 +411,6 @@ Show usage message.
380.SS Reader options
412.SS Reader options
382−.B \f[C]\-R\f[], \f[C]\-\-parse\-raw\f[]
383−Parse untranslatable HTML codes and LaTeX environments as raw HTML or
384−LaTeX, instead of ignoring them.
385−Affects only HTML and LaTeX input.
386−Raw HTML can be printed in Markdown, reStructuredText, Emacs Org mode,
387−HTML, Slidy, Slideous, DZSlides, reveal.js, and S5 output; raw LaTeX can
388−be printed in Markdown, reStructuredText, Emacs Org mode, LaTeX, and
390−The default is for the readers to omit untranslatable HTML codes and
392−(The LaTeX reader does pass through untranslatable LaTeX
393−\f[I]commands\f[], even if \f[C]\-R\f[] is not specified.)
397−.B \f[C]\-S\f[], \f[C]\-\-smart\f[]
398−Produce typographically correct output, converting straight quotes to
399−curly quotes, \f[C]\-\-\-\f[] to em\-dashes, \f[C]\-\-\f[] to
400−en\-dashes, and \f[C]\&...\f[] to ellipses.
401−Nonbreaking spaces are inserted after certain abbreviations, such as
402−\[lq]Mr.\[rq] (Note: This option is selected automatically when the
403−output format is \f[C]latex\f[] or \f[C]context\f[], unless
404−\f[C]\-\-no\-tex\-ligatures\f[] is used.
405−It has no effect for \f[C]latex\f[] input.)
409−.B \f[C]\-\-old\-dashes\f[]
410−Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
411−\f[C]\-\f[] before a numeral is an en\-dash, and \f[C]\-\-\f[] is an
413−This option is selected automatically for \f[C]textile\f[] input.
417.B \f[C]\-\-base\-header\-level=\f[]\f[I]NUMBER\f[]
414.B \f[C]\-\-base\-header\-level=\f[]\f[I]NUMBER\f[]
418Specify the base level for headers (defaults to 1).
415Specify the base level for headers (defaults to 1).
@@ -487,6 +484,37 @@ a specified full or relative path (executable or non\-executable)
487\f[C]$PATH\f[] (executable only)
484\f[C]$PATH\f[] (executable only)
487+.B \f[C]\-\-lua\-filter=\f[]\f[I]SCRIPT\f[]
488+Transform the document in a similar fashion as JSON filters (see
489+\f[C]\-\-filter\f[]), but use pandoc's build\-in lua filtering system.
490+The given lua script is expected to return a list of lua filters which
491+will be applied in order.
492+Each lua filter must contain element\-transforming functions indexed by
493+the name of the AST element on which the filter function should be
497+The \f[C]pandoc\f[] lua module provides helper functions for element
499+It is always loaded into the script's lua environment.
501+The following is an example lua script for macro\-expansion:
505+function\ expand_hello_world(inline)
506+\ \ if\ inline.c\ ==\ \[aq]{{helloworld}}\[aq]\ then
507+\ \ \ \ return\ pandoc.Emph{\ pandoc.Str\ "Hello,\ World"\ }
509+\ \ \ \ return\ inline
513+return\ {{Str\ =\ expand_hello_world}}
490.B \f[C]\-M\f[] \f[I]KEY\f[][\f[C]=\f[]\f[I]VAL\f[]], \f[C]\-\-metadata=\f[]\f[I]KEY\f[][\f[C]:\f[]\f[I]VAL\f[]]
518.B \f[C]\-M\f[] \f[I]KEY\f[][\f[C]=\f[]\f[I]VAL\f[]], \f[C]\-\-metadata=\f[]\f[I]KEY\f[][\f[C]:\f[]\f[I]VAL\f[]]
491Set the metadata field \f[I]KEY\f[] to the value \f[I]VAL\f[].
519Set the metadata field \f[I]KEY\f[] to the value \f[I]VAL\f[].
492A value specified on the command line overrides a value specified in the
520A value specified on the command line overrides a value specified in the
@@ -501,13 +529,6 @@ and may be printed in some output formats).
504−.B \f[C]\-\-normalize\f[]
505−Normalize the document after reading: merge adjacent \f[C]Str\f[] or
506−\f[C]Emph\f[] elements, for example, and remove repeated
511.B \f[C]\-p\f[], \f[C]\-\-preserve\-tabs\f[]
532.B \f[C]\-p\f[], \f[C]\-\-preserve\-tabs\f[]
512Preserve tabs instead of converting them to spaces (the default).
533Preserve tabs instead of converting them to spaces (the default).
513Note that this will only affect tabs in literal code spans and code
534Note that this will only affect tabs in literal code spans and code
@@ -539,10 +560,29 @@ This option only affects the docx reader.
541.B \f[C]\-\-extract\-media=\f[]\f[I]DIR\f[]
562.B \f[C]\-\-extract\-media=\f[]\f[I]DIR\f[]
542−Extract images and other media contained in a docx or epub container to
563+Extract images and other media contained in or linked from the source
543−the path \f[I]DIR\f[], creating it if necessary, and adjust the images
564+document to the path \f[I]DIR\f[], creating it if necessary, and adjust
544−references in the document so they point to the extracted files.
565+the images references in the document so they point to the extracted
545−This option only affects the docx and epub readers.
566+files.
567+If the source format is a binary container (docx, epub, or odt), the
568+media is extracted from the container and the original filenames are
570+Otherwise the media is read from the file system or downloaded, and new
571+filenames are constructed based on SHA1 hashes of the contents.
575+.B \f[C]\-\-abbreviations=\f[]\f[I]FILE\f[]
576+Specifies a custom abbreviations file, with abbreviations one to a line.
577+If this option is not specified, pandoc will read the data file
578+\f[C]abbreviations\f[] from the user data directory or fall back on a
580+To see the system default, use
581+\f[C]pandoc\ \-\-print\-default\-data\-file=abbreviations\f[].
582+The only use pandoc makes of this list is in the Markdown reader.
583+Strings ending in a period that are found in this list will be followed
584+by a nonbreaking space, so that the period will not produce
585+sentence\-ending space in formats like LaTeX.
548.SS General writer options
588.SS General writer options
@@ -595,6 +635,14 @@ Files in the user data directory are ignored.
638+.B \f[C]\-\-eol=crlf\f[]|\f[C]lf\f[]|\f[C]native\f[]
639+Manually specify line endings: \f[C]crlf\f[] (Windows), \f[C]lf\f[]
640+(MacOS/linux/unix), or \f[C]native\f[] (line endings appropriate to the
641+OS on which pandoc is being run).
642+The default is \f[C]native\f[].
598.B \f[C]\-\-dpi\f[]=\f[I]NUMBER\f[]
646.B \f[C]\-\-dpi\f[]=\f[I]NUMBER\f[]
599Specify the dpi (dots per inch) value for conversion from pixels to
647Specify the dpi (dots per inch) value for conversion from pixels to
600inch/centimeters and vice versa.
648inch/centimeters and vice versa.
@@ -617,11 +665,6 @@ Automatic wrapping does not currently work in HTML output.
620−.B \f[C]\-\-no\-wrap\f[]
621−Deprecated synonym for \f[C]\-\-wrap=none\f[].
625.B \f[C]\-\-columns=\f[]\f[I]NUMBER\f[]
668.B \f[C]\-\-columns=\f[]\f[I]NUMBER\f[]
626Specify length of lines in characters.
669Specify length of lines in characters.
627This affects text wrapping in the generated source code (see
670This affects text wrapping in the generated source code (see
@@ -633,11 +676,11 @@ Tables below).
634.B \f[C]\-\-toc\f[], \f[C]\-\-table\-of\-contents\f[]
677.B \f[C]\-\-toc\f[], \f[C]\-\-table\-of\-contents\f[]
635Include an automatically generated table of contents (or, in the case of
678Include an automatically generated table of contents (or, in the case of
636−\f[C]latex\f[], \f[C]context\f[], \f[C]docx\f[], and \f[C]rst\f[], an
679+\f[C]latex\f[], \f[C]context\f[], \f[C]docx\f[], \f[C]rst\f[], or
637−instruction to create one) in the output document.
680+\f[C]ms\f[], an instruction to create one) in the output document.
638−This option has no effect on \f[C]man\f[], \f[C]docbook\f[],
681+This option has no effect on \f[C]man\f[], \f[C]docbook4\f[],
639−\f[C]docbook5\f[], \f[C]slidy\f[], \f[C]slideous\f[], \f[C]s5\f[], or
682+\f[C]docbook5\f[], \f[C]jats\f[], \f[C]slidy\f[], \f[C]slideous\f[],
640−\f[C]odt\f[] output.
683+\f[C]s5\f[], or \f[C]odt\f[] output.
@@ -655,7 +698,7 @@ language attribute is given.
658−.B \f[C]\-\-highlight\-style=\f[]\f[I]STYLE\f[]
701+.B \f[C]\-\-highlight\-style=\f[]\f[I]STYLE\f[]|\f[I]FILE\f[]
659Specifies the coloring style to be used in highlighted source code.
702Specifies the coloring style to be used in highlighted source code.
660Options are \f[C]pygments\f[] (the default), \f[C]kate\f[],
703Options are \f[C]pygments\f[] (the default), \f[C]kate\f[],
661\f[C]monochrome\f[], \f[C]breezeDark\f[], \f[C]espresso\f[],
704\f[C]monochrome\f[], \f[C]breezeDark\f[], \f[C]espresso\f[],
@@ -664,6 +707,21 @@ For more information on syntax highlighting in pandoc, see Syntax
664highlighting, below.
707highlighting, below.
665See also \f[C]\-\-list\-highlight\-styles\f[].
708See also \f[C]\-\-list\-highlight\-styles\f[].
711+Instead of a \f[I]STYLE\f[] name, a JSON file with extension
712+\f[C]\&.theme\f[] may be supplied.
713+This will be parsed as a KDE syntax highlighting theme and (if valid)
714+used as the highlighting style.
715+To see a sample theme that can be modified,
716+\f[C]pandoc\ \-\-print\-default\-data\-file\ default.theme\f[].
719+.B \f[C]\-\-syntax\-definition=\f[]\f[I]FILE\f[]
720+Instructs pandoc to load a KDE XML syntax definition file, which will be
721+used for syntax highlighting of appropriately marked code blocks.
722+This can be used to add support for new languages or to use altered
723+syntax definitions for existing languages.
669.B \f[C]\-H\f[] \f[I]FILE\f[], \f[C]\-\-include\-in\-header=\f[]\f[I]FILE\f[]
727.B \f[C]\-H\f[] \f[I]FILE\f[], \f[C]\-\-include\-in\-header=\f[]\f[I]FILE\f[]
@@ -698,6 +756,19 @@ They will be included in the order specified.
698Implies \f[C]\-\-standalone\f[].
756Implies \f[C]\-\-standalone\f[].
760+.B \f[C]\-\-resource\-path=\f[]\f[I]SEARCHPATH\f[]
761+List of paths to search for images and other resources.
762+The paths should be separated by \f[C]:\f[] on linux, unix, and MacOS
763+systems, and by \f[C];\f[] on Windows.
764+If \f[C]\-\-resource\-path\f[] is not specified, the default resource
765+path is the working directory.
766+Note that, if \f[C]\-\-resource\-path\f[] is specified, the working
767+directory must be explicitly listed or it will not be searched.
768+For example: \f[C]\-\-resource\-path=.:test\f[] will search the working
769+directory and the \f[C]test\f[] subdirectory, in that order.
701.SS Options affecting specific writers
772.SS Options affecting specific writers
703.B \f[C]\-\-self\-contained\f[]
774.B \f[C]\-\-self\-contained\f[]
@@ -708,13 +779,16 @@ The resulting file should be \[lq]self\-contained,\[rq] in the sense
708that it needs no external files and no net access to be displayed
779that it needs no external files and no net access to be displayed
709properly by a browser.
780properly by a browser.
710This option works only with HTML output formats, including
781This option works only with HTML output formats, including
711−\f[C]html\f[], \f[C]html5\f[], \f[C]html+lhs\f[], \f[C]html5+lhs\f[],
782+\f[C]html4\f[], \f[C]html5\f[], \f[C]html+lhs\f[], \f[C]html5+lhs\f[],
712\f[C]s5\f[], \f[C]slidy\f[], \f[C]slideous\f[], \f[C]dzslides\f[], and
783\f[C]s5\f[], \f[C]slidy\f[], \f[C]slideous\f[], \f[C]dzslides\f[], and
713\f[C]revealjs\f[].
784\f[C]revealjs\f[].
714Scripts, images, and stylesheets at absolute URLs will be downloaded;
785Scripts, images, and stylesheets at absolute URLs will be downloaded;
715those at relative URLs will be sought relative to the working directory
786those at relative URLs will be sought relative to the working directory
716(if the first source file is local) or relative to the base URL (if the
787(if the first source file is local) or relative to the base URL (if the
717first source file is remote).
788first source file is remote).
789+Elements with the attribute \f[C]data\-external="1"\f[] will be left
790+alone; the documents they link to will not be incorporated in the
718Limitation: resources that are loaded dynamically through JavaScript
792Limitation: resources that are loaded dynamically through JavaScript
719cannot be incorporated; as a result, \f[C]\-\-self\-contained\f[] does
793cannot be incorporated; as a result, \f[C]\-\-self\-contained\f[] does
720not work with \f[C]\-\-mathjax\f[], and some advanced features
794not work with \f[C]\-\-mathjax\f[], and some advanced features
@@ -730,8 +804,8 @@ Use \f[C]<q>\f[] tags for quotes in HTML.
731.B \f[C]\-\-ascii\f[]
805.B \f[C]\-\-ascii\f[]
732Use only ASCII characters in output.
806Use only ASCII characters in output.
733−Currently supported only for HTML output (which uses numerical entities
807+Currently supported only for HTML and DocBook output (which uses
734−instead of UTF\-8 when this option is selected).
808+numerical entities instead of UTF\-8 when this option is selected).
@@ -760,11 +834,6 @@ ATX headers.
763−.B \f[C]\-\-chapters\f[]
764−Deprecated synonym for \f[C]\-\-top\-level\-division=chapter\f[].
768.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[]
837.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[]
769Treat top\-level headers as the given division type in LaTeX, ConTeXt,
838Treat top\-level headers as the given division type in LaTeX, ConTeXt,
770DocBook, and TEI output.
839DocBook, and TEI output.
@@ -805,25 +874,6 @@ Implies \f[C]\-\-number\-sections\f[].
808−.B \f[C]\-\-no\-tex\-ligatures\f[]
809−Do not use the TeX ligatures for quotation marks, apostrophes, and
810−dashes (\f[C]`...\[aq]\f[], \f[C]``..\[aq]\[aq]\f[], \f[C]\-\-\f[],
811−\f[C]\-\-\-\f[]) when writing or reading LaTeX or ConTeXt.
812−In reading LaTeX, parse the characters \f[C]`\f[], \f[C]\[aq]\f[], and
813−\f[C]\-\f[] literally, rather than parsing ligatures for quotation marks
815−In writing LaTeX or ConTeXt, print unicode quotation mark and dash
816−characters literally, rather than converting them to the standard ASCII
818−Note: normally \f[C]\-\-smart\f[] is selected automatically for LaTeX
819−and ConTeXt output, but it must be specified explicitly if
820−\f[C]\-\-no\-tex\-ligatures\f[] is selected.
821−If you use literal curly quotes, dashes, and ellipses in your source,
822−then you may want to use \f[C]\-\-no\-tex\-ligatures\f[] without
827.B \f[C]\-\-listings\f[]
877.B \f[C]\-\-listings\f[]
828Use the \f[C]listings\f[] package for LaTeX code blocks
878Use the \f[C]listings\f[] package for LaTeX code blocks
@@ -842,6 +892,8 @@ Specifies that headers with the specified level create slides (for
842Headers above this level in the hierarchy are used to divide the slide
892Headers above this level in the hierarchy are used to divide the slide
843show into sections; headers below this level create subheads within a
893show into sections; headers below this level create subheads within a
895+Note that content that is not contained under slide\-level headers will
896+not appear in the slide show.
845The default is to set the slide level based on the contents of the
897The default is to set the slide level based on the contents of the
846document; see Structuring the slide show.
898document; see Structuring the slide show.
@@ -867,8 +919,9 @@ The default is \f[C]none\f[].
869.B \f[C]\-\-id\-prefix=\f[]\f[I]STRING\f[]
921.B \f[C]\-\-id\-prefix=\f[]\f[I]STRING\f[]
870−Specify a prefix to be added to all automatically generated identifiers
922+Specify a prefix to be added to all identifiers and internal links in
871−in HTML and DocBook output, and to footnote numbers in Markdown output.
923+HTML and DocBook output, and to footnote numbers in Markdown and Haddock
872This is useful for preventing duplicate identifiers when generating
925This is useful for preventing duplicate identifiers when generating
873fragments to be included in other pages.
926fragments to be included in other pages.
@@ -887,29 +940,20 @@ Link to a CSS style sheet.
887This option can be used repeatedly to include multiple files.
940This option can be used repeatedly to include multiple files.
888They will be included in the order specified.
941They will be included in the order specified.
944+A stylesheet is required for generating EPUB.
945+If none is provided using this option (or the \f[C]stylesheet\f[]
946+metadata field), pandoc will look for a file \f[C]epub.css\f[] in the
947+user data directory (see \f[C]\-\-data\-dir\f[]).
948+If it is not found there, sensible defaults will be used.
892−.B \f[C]\-\-reference\-odt=\f[]\f[I]FILE\f[]
951+.B \f[C]\-\-reference\-doc=\f[]\f[I]FILE\f[]
893−Use the specified file as a style reference in producing an ODT.
952+Use the specified file as a style reference in producing a docx or ODT
894−For best results, the reference ODT should be a modified version of an
953+file.
895−ODT produced using pandoc.
896−The contents of the reference ODT are ignored, but its stylesheets are
898−If no reference ODT is specified on the command line, pandoc will look
899−for a file \f[C]reference.odt\f[] in the user data directory (see
900−\f[C]\-\-data\-dir\f[]).
901−If this is not found either, sensible defaults will be used.
904−To produce a custom \f[C]reference.odt\f[], first get a copy of the
905−default \f[C]reference.odt\f[]:
906−\f[C]pandoc\ \-\-print\-default\-data\-file\ reference.odt\ >\ custom\-reference.odt\f[].
907−Then open \f[C]custom\-reference.docx\f[] in LibreOffice, modify the
908−styles as you wish, and save the file.
911−.B \f[C]\-\-reference\-docx=\f[]\f[I]FILE\f[]
956+.B Docx
912−Use the specified file as a style reference in producing a docx file.
913For best results, the reference docx should be a modified version of a
957For best results, the reference docx should be a modified version of a
914docx file produced using pandoc.
958docx file produced using pandoc.
915The contents of the reference docx are ignored, but its stylesheets and
959The contents of the reference docx are ignored, but its stylesheets and
@@ -930,19 +974,30 @@ For best results, do not make changes to this file other than modifying
930the styles used by pandoc: [paragraph] Normal, Body Text, First
974the styles used by pandoc: [paragraph] Normal, Body Text, First
931Paragraph, Compact, Title, Subtitle, Author, Date, Abstract,
975Paragraph, Compact, Title, Subtitle, Author, Date, Abstract,
932Bibliography, Heading 1, Heading 2, Heading 3, Heading 4, Heading 5,
976Bibliography, Heading 1, Heading 2, Heading 3, Heading 4, Heading 5,
933−Heading 6, Block Text, Footnote Text, Definition Term, Definition,
977+Heading 6, Heading 7, Heading 8, Heading 9, Block Text, Footnote Text,
934−Caption, Table Caption, Image Caption, Figure, Figure With Caption, TOC
978+Definition Term, Definition, Caption, Table Caption, Image Caption,
935−Heading; [character] Default Paragraph Font, Body Text Char, Verbatim
979+Figure, Captioned Figure, TOC Heading; [character] Default Paragraph
936−Char, Footnote Reference, Hyperlink; [table] Normal Table.
980+Font, Body Text Char, Verbatim Char, Footnote Reference, Hyperlink;
939−.B \f[C]\-\-epub\-stylesheet=\f[]\f[I]FILE\f[]
984+.B ODT
940−Use the specified CSS file to style the EPUB.
985+For best results, the reference ODT should be a modified version of an
986+ODT produced using pandoc.
987+The contents of the reference ODT are ignored, but its stylesheets are
941−If no stylesheet is specified, pandoc will look for a file
989+If no reference ODT is specified on the command line, pandoc will look
942−\f[C]epub.css\f[] in the user data directory (see
990+for a file \f[C]reference.odt\f[] in the user data directory (see
943\f[C]\-\-data\-dir\f[]).
991\f[C]\-\-data\-dir\f[]).
944−If it is not found there, sensible defaults will be used.
992+If this is not found either, sensible defaults will be used.
995+To produce a custom \f[C]reference.odt\f[], first get a copy of the
996+default \f[C]reference.odt\f[]:
997+\f[C]pandoc\ \-\-print\-default\-data\-file\ reference.odt\ >\ custom\-reference.odt\f[].
998+Then open \f[C]custom\-reference.odt\f[] in LibreOffice, modify the
999+styles as you wish, and save the file.
948.B \f[C]\-\-epub\-cover\-image=\f[]\f[I]FILE\f[]
1003.B \f[C]\-\-epub\-cover\-image=\f[]\f[I]FILE\f[]
@@ -989,7 +1044,7 @@ However, if you use wildcards on the command line, be sure to escape
989them or put the whole filename in single quotes, to prevent them from
1044them or put the whole filename in single quotes, to prevent them from
990being interpreted by the shell.
1045being interpreted by the shell.
991To use the embedded fonts, you will need to add declarations like the
1046To use the embedded fonts, you will need to add declarations like the
992−following to your CSS (see \f[C]\-\-epub\-stylesheet\f[]):
1047+following to your CSS (see \f[C]\-\-css\f[]):
@@ -1115,12 +1170,9 @@ copy of the script, so it can be cached.
1118−.B \f[C]\-\-mathml\f[][\f[C]=\f[]\f[I]URL\f[]]
1173+.B \f[C]\-\-mathml\f[]
1119−Convert TeX math to MathML (in \f[C]docbook\f[], \f[C]docbook5\f[],
1174+Convert TeX math to MathML (in \f[C]docbook4\f[], \f[C]docbook5\f[],
1120−\f[C]html\f[] and \f[C]html5\f[]).
1175+\f[C]jats\f[], \f[C]html4\f[] and \f[C]html5\f[]).
1121−In standalone \f[C]html\f[] output, a small JavaScript (or a link to
1122−such a script if a \f[I]URL\f[] is supplied) will be inserted that
1123−allows the MathML to be viewed on some browsers.
@@ -1252,7 +1304,7 @@ For \f[C]pdf\f[] output, customize the \f[C]default.latex\f[] template
1252use \f[C]\-t\ context\f[]).
1304use \f[C]\-t\ context\f[]).
1253.IP \[bu] 2
1305.IP \[bu] 2
1254\f[C]docx\f[] has no template (however, you can use
1306\f[C]docx\f[] has no template (however, you can use
1255−\f[C]\-\-reference\-docx\f[] to customize the output).
1307+\f[C]\-\-reference\-doc\f[] to customize the output).
1257Templates contain \f[I]variables\f[], which allow for the inclusion of
1309Templates contain \f[I]variables\f[], which allow for the inclusion of
1258arbitrary information at any point in the file.
1310arbitrary information at any point in the file.
@@ -1266,6 +1318,29 @@ Some variables are set automatically by pandoc.
1266These vary somewhat depending on the output format, but include metadata
1318These vary somewhat depending on the output format, but include metadata
1267fields as well as the following:
1319fields as well as the following:
1321+.B \f[C]sourcefile\f[], \f[C]outputfile\f[]
1322+source and destination filenames, as given on the command line.
1323+\f[C]sourcefile\f[] can also be a list if input comes from multiple
1324+files, or empty if input is from stdin.
1325+You can use the following snippet in your template to distinguish them:
1340+Similarly, \f[C]outputfile\f[] can be \f[C]\-\f[] if output goes to the
1269.B \f[C]title\f[], \f[C]author\f[], \f[C]date\f[]
1344.B \f[C]title\f[], \f[C]author\f[], \f[C]date\f[]
1270allow identification of basic aspects of the document.
1345allow identification of basic aspects of the document.
1271Included in PDF metadata through LaTeX and ConTeXt.
1346Included in PDF metadata through LaTeX and ConTeXt.
@@ -1344,7 +1419,8 @@ body of document
1346.B \f[C]meta\-json\f[]
1421.B \f[C]meta\-json\f[]
1347−JSON representation of all of the document's metadata
1422+JSON representation of all of the document's metadata.
1423+Field values are transformed to the selected output format.
1350.SS Language variables
1426.SS Language variables
@@ -1398,6 +1474,16 @@ engine is fully supported (use \f[C]\-\-latex\-engine=xelatex\f[]).
1398Variables are available for producing slide shows with pandoc, including
1474Variables are available for producing slide shows with pandoc, including
1399all reveal.js configuration options.
1475all reveal.js configuration options.
1477+.B \f[C]titlegraphic\f[]
1478+title graphic for Beamer documents
1483+logo for Beamer documents
1401.B \f[C]slidy\-url\f[]
1487.B \f[C]slidy\-url\f[]
1402base URL for Slidy documents (defaults to
1488base URL for Slidy documents (defaults to
1403\f[C]http://www.w3.org/Talks/Tools/Slidy2\f[])
1489\f[C]http://www.w3.org/Talks/Tools/Slidy2\f[])
@@ -1467,7 +1553,7 @@ LaTeX variables are used when creating a PDF.
1468.B \f[C]papersize\f[]
1554.B \f[C]papersize\f[]
1469paper size, e.g.
1555paper size, e.g.
1470−\f[C]letter\f[], \f[C]A4\f[]
1556+\f[C]letter\f[], \f[C]a4\f[]
@@ -1745,6 +1831,31 @@ adjusts text to left (\f[C]l\f[]), right (\f[C]r\f[]), center
1745if \f[C]true\f[] (the default), hyphenation will be used
1831if \f[C]true\f[] (the default), hyphenation will be used
1834+.SS Variables for ms
1836+.B \f[C]pointsize\f[]
1842+.B \f[C]lineheight\f[]
1848+.B \f[C]fontfamily\f[]
1850+\f[C]T\f[] or \f[C]P\f[])
1855+paragraph indent (e.g.
1748.SS Using variables in templates
1859.SS Using variables in templates
1750Variable names are sequences of alphanumerics, \f[C]\-\f[], and
1861Variable names are sequences of alphanumerics, \f[C]\-\f[], and
@@ -1925,6 +2036,12 @@ I\ like\ several\ of\ their\ flavors\ of\ ice\ cream:
1925#22,\ for\ example,\ and\ #5.
2036#22,\ for\ example,\ and\ #5.
2039+.SS Extension: \f[C]space_in_atx_header\f[]
2041+Many Markdown implementations do not require a space between the opening
2042+\f[C]#\f[]s of an ATX header and the header text, so that
2043+\f[C]#5\ bolt\f[] and \f[C]#hashtag\f[] count as headers.
2044+With this extension, pandoc does require the space.
1928.SS Header identifiers
2045.SS Header identifiers
1929.SS Extension: \f[C]header_attributes\f[]
2046.SS Extension: \f[C]header_attributes\f[]
@@ -2065,9 +2182,9 @@ only in HTML, LaTeX, and ConTeXt formats.
2066If the \f[C]\-\-section\-divs\f[] option is specified, then each section
2183If the \f[C]\-\-section\-divs\f[] option is specified, then each section
2067will be wrapped in a \f[C]div\f[] (or a \f[C]section\f[], if
2184will be wrapped in a \f[C]div\f[] (or a \f[C]section\f[], if
2068−\f[C]\-\-html5\f[] was specified), and the identifier will be attached
2185+\f[C]html5\f[] was specified), and the identifier will be attached to
2069−to the enclosing \f[C]<div>\f[] (or \f[C]<section>\f[]) tag rather than
2186+the enclosing \f[C]<div>\f[] (or \f[C]<section>\f[]) tag rather than the
2070−the header itself.
2187+header itself.
2071This allows entire sections to be manipulated using JavaScript or
2188This allows entire sections to be manipulated using JavaScript or
2072treated differently in CSS.
2189treated differently in CSS.
2073.SS Extension: \f[C]implicit_header_references\f[]
2190.SS Extension: \f[C]implicit_header_references\f[]
@@ -2285,10 +2402,10 @@ Here \f[C]mycode\f[] is an identifier, \f[C]haskell\f[] and
2285\f[C]numberLines\f[] are classes, and \f[C]startFrom\f[] is an attribute
2402\f[C]numberLines\f[] are classes, and \f[C]startFrom\f[] is an attribute
2286with value \f[C]100\f[].
2403with value \f[C]100\f[].
2287Some output formats can use this information to do syntax highlighting.
2404Some output formats can use this information to do syntax highlighting.
2288−Currently, the only output formats that uses this information are HTML
2405+Currently, the only output formats that uses this information are HTML,
2290−If highlighting is supported for your output format and language, then
2406+LaTeX, Docx, and Ms.\ If highlighting is supported for your output
2291−the code block above will appear highlighted, with numbered lines.
2407+format and language, then the code block above will appear highlighted,
2408+with numbered lines.
2292(To see which languages are supported, type
2409(To see which languages are supported, type
2293\f[C]pandoc\ \-\-list\-highlight\-languages\f[].) Otherwise, the code
2410\f[C]pandoc\ \-\-list\-highlight\-languages\f[].) Otherwise, the code
2294block above will appear as follows:
2411block above will appear as follows:
@@ -3164,7 +3281,8 @@ Note that YAML escaping rules must be followed.
3164Thus, for example, if a title contains a colon, it must be quoted.
3281Thus, for example, if a title contains a colon, it must be quoted.
3165The pipe character (\f[C]|\f[]) can be used to begin an indented block
3282The pipe character (\f[C]|\f[]) can be used to begin an indented block
3166that will be interpreted literally, without need for escaping.
3283that will be interpreted literally, without need for escaping.
3167−This form is necessary when the field contains blank lines:
3284+This form is necessary when the field contains blank lines or
3285+block\-level formatting:
@@ -3283,19 +3401,6 @@ This is a nice alternative to Markdown's \[lq]invisible\[rq] way of
3283indicating hard line breaks using two trailing spaces on a line.
3401indicating hard line breaks using two trailing spaces on a line.
3285Backslash escapes do not work in verbatim contexts.
3403Backslash escapes do not work in verbatim contexts.
3286−.SS Smart punctuation
3289−If the \f[C]\-\-smart\f[] option is specified, pandoc will produce
3290−typographically correct output, converting straight quotes to curly
3291−quotes, \f[C]\-\-\-\f[] to em\-dashes, \f[C]\-\-\f[] to en\-dashes, and
3292−\f[C]\&...\f[] to ellipses.
3293−Nonbreaking spaces are inserted after certain abbreviations, such as
3296−Note: if your LaTeX template or any included header file call for the
3297−\f[C]csquotes\f[] package, pandoc will detect this automatically and use
3298−\f[C]\\enquote{...}\f[] for quoted text.
3299.SS Inline formatting
3404.SS Inline formatting
3300.SS Emphasis
3405.SS Emphasis
@@ -3560,7 +3665,9 @@ If the \f[C]\-\-webtex\f[] option is used, TeX formulas will be
3560converted to \f[C]<img>\f[] tags that link to an external script that
3665converted to \f[C]<img>\f[] tags that link to an external script that
3561converts formulas to images.
3666converts formulas to images.
3562The formula will be URL\-encoded and concatenated with the URL provided.
3667The formula will be URL\-encoded and concatenated with the URL provided.
3668+For SVG images you can for example use
3669+\f[C]\-\-webtex\ https://latex.codecogs.com/svg.latex?\f[].
3563−If no URL is specified, the CodeCogs will be used
3670+If no URL is specified, the CodeCogs URL generating PNGs will be used
3564(\f[C]https://latex.codecogs.com/png.latex?\f[]).
3671(\f[C]https://latex.codecogs.com/png.latex?\f[]).
3565.IP "7." 3
3672.IP "7." 3
3566If the \f[C]\-\-mathjax\f[] option is used, TeX math will be displayed
3673If the \f[C]\-\-mathjax\f[] option is used, TeX math will be displayed
@@ -3742,10 +3849,11 @@ before or after the link).
3743The link consists of link text in square brackets, followed by a label
3850The link consists of link text in square brackets, followed by a label
3744in square brackets.
3851in square brackets.
3745−(There can be space between the two.) The link definition consists of
3852+(There cannot be space between the two unless the
3853+\f[C]spaced_reference_links\f[] extension is enabled.) The link
3746−the bracketed label, followed by a colon and a space, followed by the
3854+definition consists of the bracketed label, followed by a colon and a
3747−URL, and optionally (after a space) a link title either in quotes or in
3855+space, followed by the URL, and optionally (after a space) a link title
3748−parentheses.
3856+either in quotes or in parentheses.
3749The label must not be parseable as a citation (assuming the
3857The label must not be parseable as a citation (assuming the
3750\f[C]citations\f[] extension is enabled): citations take precedence over
3858\f[C]citations\f[] extension is enabled): citations take precedence over
3751link labels.
3859link labels.
@@ -3887,6 +3995,10 @@ One way to do this is to insert a nonbreaking space after the image:
3887![This\ image\ won\[aq]t\ be\ a\ figure](/url/of/image.png)\\\
3995![This\ image\ won\[aq]t\ be\ a\ figure](/url/of/image.png)\\\
3999+Note that in reveal.js slide shows, an image in a paragraph by itself
4000+that has the \f[C]stretch\f[] class will fill the screen, and the
4001+caption and figure tags will be omitted.
3890.SS Extension: \f[C]link_attributes\f[]
4002.SS Extension: \f[C]link_attributes\f[]
3892Attributes can be set on links and images:
4004Attributes can be set on links and images:
@@ -4006,6 +4118,31 @@ note.]
4008Inline and regular footnotes may be mixed freely.
4120Inline and regular footnotes may be mixed freely.
4122+.SS Extension: \f[C]smart\f[]
4124+Interpret straight quotes as curly quotes, \f[C]\-\-\-\f[] as
4125+em\-dashes, \f[C]\-\-\f[] as en\-dashes, and \f[C]\&...\f[] as ellipses.
4126+Nonbreaking spaces are inserted after certain abbreviations, such as
4127+\[lq]Mr.\[rq] This option currently affects the input formats
4128+\f[C]markdown\f[], \f[C]commonmark\f[], \f[C]latex\f[],
4129+\f[C]mediawiki\f[], \f[C]org\f[], \f[C]rst\f[], and \f[C]twiki\f[], and
4130+the output formats \f[C]markdown\f[], \f[C]latex\f[], and
4133+Note: If you are \f[I]writing\f[] Markdown, then the \f[C]smart\f[]
4134+extension has the reverse effect: what would have been curly quotes
4137+In LaTeX, \f[C]smart\f[] means to use the standard TeX ligatures for
4138+quotation marks (\f[C]``\f[] and \f[C]\[aq]\[aq]\f[] for double quotes,
4139+\f[C]`\f[] and \f[C]\[aq]\f[] for single quotes) and dashes
4140+(\f[C]\-\-\f[] for en\-dash and \f[C]\-\-\-\f[] for em\-dash).
4141+If \f[C]smart\f[] is disabled, then in reading LaTeX pandoc will parse
4142+these characters literally.
4143+In writing LaTeX, enabling \f[C]smart\f[] tells pandoc to use the
4144+ligatures when possible; if \f[C]smart\f[] is disabled pandoc will use
4145+unicode quotation mark and dash characters.
4009.SS Citations
4146.SS Citations
4010.SS Extension: \f[C]citations\f[]
4147.SS Extension: \f[C]citations\f[]
@@ -4311,6 +4448,13 @@ pandoc, but may be enabled by adding \f[C]+EXTENSION\f[] to the format
4311name, where \f[C]EXTENSION\f[] is the name of the extension.
4448name, where \f[C]EXTENSION\f[] is the name of the extension.
4312Thus, for example, \f[C]markdown+hard_line_breaks\f[] is Markdown with
4449Thus, for example, \f[C]markdown+hard_line_breaks\f[] is Markdown with
4313hard line breaks.
4450hard line breaks.
4451+.SS Extension: \f[C]old_dashes\f[]
4453+Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
4454+\f[C]\-\f[] before a numeral is an en\-dash, and \f[C]\-\-\f[] is an
4456+This option only has an effect if \f[C]smart\f[] is enabled.
4457+It is selected automatically for \f[C]textile\f[] input.
4314.SS Extension: \f[C]angle_brackets_escapable\f[]
4458.SS Extension: \f[C]angle_brackets_escapable\f[]
4316Allow \f[C]<\f[] and \f[C]>\f[] to be backslash\-escaped, as they can be
4460Allow \f[C]<\f[] and \f[C]>\f[] to be backslash\-escaped, as they can be
@@ -4320,6 +4464,16 @@ This is implied by pandoc's default \f[C]all_symbols_escapable\f[].
4321Allow a list to occur right after a paragraph, with no intervening blank
4465Allow a list to occur right after a paragraph, with no intervening blank
4467+.SS Extension: \f[C]spaced_reference_links\f[]
4469+Allow whitespace between the two components of a reference link, for
4323.SS Extension: \f[C]hard_line_breaks\f[]
4477.SS Extension: \f[C]hard_line_breaks\f[]
4325Causes all newlines within a paragraph to be interpreted as hard line
4479Causes all newlines within a paragraph to be interpreted as hard line
@@ -4593,6 +4747,9 @@ Headers \f[I]above\f[] the slide level in the hierarchy create
4593\[lq]title slides,\[rq] which just contain the section title and help to
4747\[lq]title slides,\[rq] which just contain the section title and help to
4594break the slide show into sections.
4748break the slide show into sections.
4595.IP \[bu] 2
4749.IP \[bu] 2
4750+Content \f[I]above\f[] the slide level will not appear in the slide
4596A title page is constructed automatically from the document's title
4753A title page is constructed automatically from the document's title
4597block, if present.
4754block, if present.
4598(In the case of beamer, this can be disabled by commenting out some
4755(In the case of beamer, this can be disabled by commenting out some
@@ -4887,7 +5044,7 @@ For example:
4887If you append \f[C]+lhs\f[] (or \f[C]+literate_haskell\f[]) to an
5044If you append \f[C]+lhs\f[] (or \f[C]+literate_haskell\f[]) to an
4888appropriate input or output format (\f[C]markdown\f[],
5045appropriate input or output format (\f[C]markdown\f[],
4889\f[C]markdown_strict\f[], \f[C]rst\f[], or \f[C]latex\f[] for input or
5046\f[C]markdown_strict\f[], \f[C]rst\f[], or \f[C]latex\f[] for input or
4890−output; \f[C]beamer\f[], \f[C]html\f[] or \f[C]html5\f[] for output
5047+output; \f[C]beamer\f[], \f[C]html4\f[] or \f[C]html5\f[] for output
4891only), pandoc will treat the document as literate Haskell source.
5048only), pandoc will treat the document as literate Haskell source.
4892This means that
5049This means that
4893.IP \[bu] 2
5050.IP \[bu] 2
@@ -4940,12 +5097,16 @@ pandoc\ \-f\ markdown+lhs\ \-t\ html+lhs
4941writes HTML with the Haskell code in bird tracks, so it can be copied
5098writes HTML with the Haskell code in bird tracks, so it can be copied
4942and pasted as literate Haskell source.
5099and pasted as literate Haskell source.
5101+Note that GHC expects the bird tracks in the first column, so indentend
5102+literate code blocks (e.g.\ inside an itemized environment) will not be
5103+picked up by the Haskell compiler.
4943.SH SYNTAX HIGHLIGHTING
5104.SH SYNTAX HIGHLIGHTING
4945Pandoc will automatically highlight syntax in fenced code blocks that
5106Pandoc will automatically highlight syntax in fenced code blocks that
4946are marked with a language name.
5107are marked with a language name.
4947−The Haskell library highlighting\-kate is used for highlighting, which
5108+The Haskell library skylighting is used for highlighting, which works in
4948−works in HTML, Docx, and LaTeX/PDF output.
5109+HTML, Docx, Ms, and LaTeX/PDF output.
4949To see a list of language names that pandoc will recognize, type
5110To see a list of language names that pandoc will recognize, type
4950\f[C]pandoc\ \-\-list\-highlight\-languages\f[].
5111\f[C]pandoc\ \-\-list\-highlight\-languages\f[].
@@ -5038,7 +5199,7 @@ pandoc\ \-\-print\-default\-data\-file\ sample.lua
5039.SH AUTHORS
5200.SH AUTHORS
5041−© 2006\-2016 John MacFarlane (jgm\@berkeley.edu).
5202+© 2006\-2017 John MacFarlane (jgm\@berkeley.edu).
5042Released under the GPL, version 2 or greater.
5203Released under the GPL, version 2 or greater.
5043This software carries no warranty of any kind.
5204This software carries no warranty of any kind.
5044(See COPYRIGHT for full copyright and warranty notices.)
5205(See COPYRIGHT for full copyright and warranty notices.)