@@ -1,5 +1,5 @@
2−.TH PANDOC 1 "December 8, 2017" "pandoc 2.0.5"
2+.TH PANDOC 1 "December 27, 2017" "pandoc 2.0.6"
4pandoc - general markup converter
4pandoc - general markup converter
5.SH SYNOPSIS
5.SH SYNOPSIS
@@ -12,16 +12,16 @@ another, and a command\-line tool that uses this library.
12It can read Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
12It can read Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
13Markdown, MultiMarkdown, and (subsets of) Textile, reStructuredText,
13Markdown, MultiMarkdown, and (subsets of) Textile, reStructuredText,
14HTML, LaTeX, MediaWiki markup, TWiki markup, TikiWiki markup, Creole
14HTML, LaTeX, MediaWiki markup, TWiki markup, TikiWiki markup, Creole
15−1.0, Haddock markup, OPML, Emacs Org mode, DocBook, Muse, txt2tags,
15+1.0, Haddock markup, OPML, Emacs Org mode, DocBook, JATS, Muse,
16−Vimwiki, EPUB, ODT, and Word docx; and it can write plain text,
16+txt2tags, Vimwiki, EPUB, ODT, and Word docx; and it can write plain
17−Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored Markdown,
17+text, Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
18−MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX (including
18+Markdown, MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX
19−\f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook, OpenDocument,
19+(including \f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook,
20−ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki markup, ZimWiki
20+JATS, OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup,
21−markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile, groff
21+DokuWiki markup, ZimWiki markup, Haddock markup, EPUB (v2 or v3),
22−man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML, TEI Simple,
22+FictionBook2, Textile, groff man, groff ms, Emacs Org mode, AsciiDoc,
23−Muse, PowerPoint slide shows and Slidy, Slideous, DZSlides, reveal.js or
23+InDesign ICML, TEI Simple, Muse, PowerPoint slide shows and Slidy,
24−S5 HTML slide shows.
24+Slideous, DZSlides, reveal.js or S5 HTML slide shows.
25It can also produce PDF output on systems where LaTeX, ConTeXt,
25It can also produce PDF output on systems where LaTeX, ConTeXt,
26\f[C]pdfroff\f[], \f[C]wkhtmltopdf\f[], \f[C]prince\f[], or
26\f[C]pdfroff\f[], \f[C]wkhtmltopdf\f[], \f[C]prince\f[], or
27\f[C]weasyprint\f[] is installed.
27\f[C]weasyprint\f[] is installed.
@@ -2911,6 +2911,13 @@ As\ (\@good)\ illustrates,\ ...
2912The label can be any string of alphanumeric characters, underscores, or
2912The label can be any string of alphanumeric characters, underscores, or
2915+Note: continuation paragraphs in example lists must always be indented
2916+four spaces, regardless of the length of the list marker.
2917+That is, example lists always behave as if the \f[C]four_space_rule\f[]
2919+This is because example labels tend to be long, and indenting content to
2920+the first non\-space character after the label would be awkward.
2914.SS Compact and loose lists
2921.SS Compact and loose lists
2916Pandoc behaves differently from \f[C]Markdown.pl\f[] on some "edge
2923Pandoc behaves differently from \f[C]Markdown.pl\f[] on some "edge
@@ -3951,9 +3958,9 @@ The raw attribute cannot be combined with regular attributes.
3951.SS LaTeX macros
3958.SS LaTeX macros
3952.SS Extension: \f[C]latex_macros\f[]
3959.SS Extension: \f[C]latex_macros\f[]
3954−For output formats other than LaTeX, pandoc will parse LaTeX
3961+For output formats other than LaTeX, pandoc will parse LaTeX macro
3955−\f[C]\\newcommand\f[] and \f[C]\\renewcommand\f[] definitions and apply
3956−the resulting macros to all LaTeX math.
3962+definitions and apply the resulting macros to all LaTeX math and raw
3957So, for example, the following will work in all output formats, not just
3964So, for example, the following will work in all output formats, not just
@@ -3965,8 +3972,13 @@ $\\tuple{a,\ b,\ c}$
3968−In LaTeX output, the \f[C]\\newcommand\f[] definition will simply be
3975+In LaTeX output, the macro definitions will not be passed through as raw
3969−passed unchanged to the output.
3976+LaTeX.
3978+When \f[C]latex_macros\f[] is disabled, the macro definitions will be
3979+passed through as raw LaTeX, and the raw LaTeX and math will not have
3981+This is usually a better approach when you are targeting LaTeX or PDF.
3970.SS Links
3982.SS Links
3972Markdown allows links to be specified in several ways.
3984Markdown allows links to be specified in several ways.
@@ -4298,6 +4310,8 @@ Nonbreaking spaces are inserted after certain abbreviations, such as
4298\f[C]commonmark\f[], \f[C]latex\f[], \f[C]mediawiki\f[], \f[C]org\f[],
4310\f[C]commonmark\f[], \f[C]latex\f[], \f[C]mediawiki\f[], \f[C]org\f[],
4299\f[C]rst\f[], and \f[C]twiki\f[], and the output formats
4311\f[C]rst\f[], and \f[C]twiki\f[], and the output formats
4300\f[C]markdown\f[], \f[C]latex\f[], and \f[C]context\f[].
4312\f[C]markdown\f[], \f[C]latex\f[], and \f[C]context\f[].
4313+It is enabled by default for \f[C]markdown\f[], \f[C]latex\f[], and
4314+\f[C]context\f[] (in both input and output).
4302Note: If you are \f[I]writing\f[] Markdown, then the \f[C]smart\f[]
4316Note: If you are \f[I]writing\f[] Markdown, then the \f[C]smart\f[]
4303extension has the reverse effect: what would have been curly quotes
4317extension has the reverse effect: what would have been curly quotes
@@ -5395,26 +5409,26 @@ blocks and text using \f[C]div\f[]s and \f[C]span\f[]s, respectively.
5395If you define a \f[C]div\f[] or \f[C]span\f[] with the attribute
5409If you define a \f[C]div\f[] or \f[C]span\f[] with the attribute
5396\f[C]custom\-style\f[], pandoc will apply your specified style to the
5410\f[C]custom\-style\f[], pandoc will apply your specified style to the
5397contained elements.
5411contained elements.
5398−So, for example,
5412+So, for example using the \f[C]bracketed_spans\f[] syntax,
5402−<span\ custom\-style="Emphatically">Get\ out,</span>\ he\ said.
5416+[Get\ out]{custom\-style="Emphatically"},\ he\ said.
5406−would produce a docx file with "Get out," styled with character style
5420+would produce a docx file with "Get out" styled with character style
5407\f[C]Emphatically\f[].
5421\f[C]Emphatically\f[].
5408−Similarly,
5422+Similarly, using the \f[C]fenced_divs\f[] syntax,
5412Dickinson\ starts\ the\ poem\ simply:
5426Dickinson\ starts\ the\ poem\ simply:
5414−<div\ custom\-style="Poetry">
5428+:::\ {custom\-style="Poetry"}
5415|\ A\ Bird\ came\ down\ the\ Walk\-\-\-
5429|\ A\ Bird\ came\ down\ the\ Walk\-\-\-
5416|\ He\ did\ not\ know\ I\ saw\-\-\-
5430|\ He\ did\ not\ know\ I\ saw\-\-\-