@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "December 8, 2017" "pandoc 2.0.5"
2+.TH PANDOC 1 "December 27, 2017" "pandoc 2.0.6"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -12,16 +12,16 @@ another, and a command\-line tool that uses this library.
1212It can read Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
1313Markdown, MultiMarkdown, and (subsets of) Textile, reStructuredText,
1414HTML, LaTeX, MediaWiki markup, TWiki markup, TikiWiki markup, Creole
15−1.0, Haddock markup, OPML, Emacs Org mode, DocBook, Muse, txt2tags,
16−Vimwiki, EPUB, ODT, and Word docx; and it can write plain text,
17−Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored Markdown,
18−MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX (including
19−\f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook, OpenDocument,
20−ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki markup, ZimWiki
21−markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile, groff
22−man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML, TEI Simple,
23−Muse, PowerPoint slide shows and Slidy, Slideous, DZSlides, reveal.js or
24−S5 HTML slide shows.
15+1.0, Haddock markup, OPML, Emacs Org mode, DocBook, JATS, Muse,
16+txt2tags, Vimwiki, EPUB, ODT, and Word docx; and it can write plain
17+text, Markdown, CommonMark, PHP Markdown Extra, GitHub\-Flavored
18+Markdown, MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX
19+(including \f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook,
20+JATS, OpenDocument, ODT, Word docx, GNU Texinfo, MediaWiki markup,
21+DokuWiki markup, ZimWiki markup, Haddock markup, EPUB (v2 or v3),
22+FictionBook2, Textile, groff man, groff ms, Emacs Org mode, AsciiDoc,
23+InDesign ICML, TEI Simple, Muse, PowerPoint slide shows and Slidy,
24+Slideous, DZSlides, reveal.js or S5 HTML slide shows.
2525It can also produce PDF output on systems where LaTeX, ConTeXt,
2626\f[C]pdfroff\f[], \f[C]wkhtmltopdf\f[], \f[C]prince\f[], or
2727\f[C]weasyprint\f[] is installed.
@@ -2911,6 +2911,13 @@ As\ (\@good)\ illustrates,\ ...
29112911.PP
29122912The label can be any string of alphanumeric characters, underscores, or
29132913hyphens.
2914+.PP
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[]
2918+extension is set.
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.
29142921.SS Compact and loose lists
29152922.PP
29162923Pandoc behaves differently from \f[C]Markdown.pl\f[] on some "edge
@@ -3951,9 +3958,9 @@ The raw attribute cannot be combined with regular attributes.
39513958.SS LaTeX macros
39523959.SS Extension: \f[C]latex_macros\f[]
39533960.PP
3954−For output formats other than LaTeX, pandoc will parse LaTeX
3955−\f[C]\\newcommand\f[] and \f[C]\\renewcommand\f[] definitions and apply
3956−the resulting macros to all LaTeX math.
3961+For output formats other than LaTeX, pandoc will parse LaTeX macro
3962+definitions and apply the resulting macros to all LaTeX math and raw
3963+LaTeX.
39573964So, for example, the following will work in all output formats, not just
39583965LaTeX:
39593966.IP
@@ -3965,8 +3972,13 @@ $\\tuple{a,\ b,\ c}$
39653972\f[]
39663973.fi
39673974.PP
3968−In LaTeX output, the \f[C]\\newcommand\f[] definition will simply be
3969−passed unchanged to the output.
3975+In LaTeX output, the macro definitions will not be passed through as raw
3976+LaTeX.
3977+.PP
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
3980+macros applied.
3981+This is usually a better approach when you are targeting LaTeX or PDF.
39703982.SS Links
39713983.PP
39723984Markdown allows links to be specified in several ways.
@@ -4298,6 +4310,8 @@ Nonbreaking spaces are inserted after certain abbreviations, such as
42984310\f[C]commonmark\f[], \f[C]latex\f[], \f[C]mediawiki\f[], \f[C]org\f[],
42994311\f[C]rst\f[], and \f[C]twiki\f[], and the output formats
43004312\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).
43014315.PP
43024316Note: If you are \f[I]writing\f[] Markdown, then the \f[C]smart\f[]
43034317extension 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.
53955409If you define a \f[C]div\f[] or \f[C]span\f[] with the attribute
53965410\f[C]custom\-style\f[], pandoc will apply your specified style to the
53975411contained elements.
5398−So, for example,
5412+So, for example using the \f[C]bracketed_spans\f[] syntax,
53995413.IP
54005414.nf
54015415\f[C]
5402−<span\ custom\-style="Emphatically">Get\ out,</span>\ he\ said.
5416+[Get\ out]{custom\-style="Emphatically"},\ he\ said.
54035417\f[]
54045418.fi
54055419.PP
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
54075421\f[C]Emphatically\f[].
5408−Similarly,
5422+Similarly, using the \f[C]fenced_divs\f[] syntax,
54095423.IP
54105424.nf
54115425\f[C]
54125426Dickinson\ starts\ the\ poem\ simply:
54135427
5414−<div\ custom\-style="Poetry">
5428+:::\ {custom\-style="Poetry"}
54155429|\ A\ Bird\ came\ down\ the\ Walk\-\-\-
54165430|\ He\ did\ not\ know\ I\ saw\-\-\-
5417−</div>
5431+:::
54185432\f[]
54195433.fi
54205434.PP