git.iko.soy/typeable/pandoc
on master help sign in
Update man page.
75fa139John MacFarlane
man/pandoc.1+36−9
@@ -1,5 +1,5 @@
1.\"t
1.\"t
2−.TH PANDOC 1 "December 2, 2017" "pandoc 2.0.4"
2+.TH PANDOC 1 "December 8, 2017" "pandoc 2.1"
3.SH NAME
3.SH NAME
4pandoc - general markup converter
4pandoc - general markup converter
5.SH SYNOPSIS
5.SH SYNOPSIS
@@ -19,8 +19,9 @@ MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX (including
19\f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook, OpenDocument,
19\f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook, OpenDocument,
20ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki markup, ZimWiki
20ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki markup, ZimWiki
21markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile, groff
21markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile, groff
22−man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML, TEI Simple, Muse
22+man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML, TEI Simple,
23−and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide shows.
23+Muse, PowerPoint slide shows and Slidy, Slideous, DZSlides, reveal.js or
24+S5 HTML slide shows.
24It can also produce PDF output on systems where LaTeX, ConTeXt,
25It can also produce PDF output on systems where LaTeX, ConTeXt,
25\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
26\f[C]weasyprint\f[] is installed.
27\f[C]weasyprint\f[] is installed.
@@ -286,8 +287,8 @@ e\-book), \f[C]asciidoc\f[] (AsciiDoc), \f[C]icml\f[] (InDesign ICML),
286slide show), \f[C]slideous\f[] (Slideous HTML and JavaScript slide
287slide show), \f[C]slideous\f[] (Slideous HTML and JavaScript slide
287show), \f[C]dzslides\f[] (DZSlides HTML5 + JavaScript slide show),
288show), \f[C]dzslides\f[] (DZSlides HTML5 + JavaScript slide show),
288\f[C]revealjs\f[] (reveal.js HTML5 + JavaScript slide show), \f[C]s5\f[]
289\f[C]revealjs\f[] (reveal.js HTML5 + JavaScript slide show), \f[C]s5\f[]
289−(S5 HTML and JavaScript slide show), or the path of a custom lua writer
290+(S5 HTML and JavaScript slide show), \f[C]pptx\f[] (PowerPoint slide
290−(see Custom writers, below).
291+show) or the path of a custom lua writer (see Custom writers, below).
291(\f[C]markdown_github\f[] provides deprecated and less accurate support
292(\f[C]markdown_github\f[] provides deprecated and less accurate support
292for Github\-Flavored Markdown; please use \f[C]gfm\f[] instead, unless
293for Github\-Flavored Markdown; please use \f[C]gfm\f[] instead, unless
293you use extensions that do not work with \f[C]gfm\f[].) Note that
294you use extensions that do not work with \f[C]gfm\f[].) Note that
@@ -432,7 +433,8 @@ Specify the base level for headers (defaults to 1).
432.RE
433.RE
433.TP
434.TP
434.B \f[C]\-\-strip\-empty\-paragraphs\f[]
435.B \f[C]\-\-strip\-empty\-paragraphs\f[]
436+\f[I]Deprecated. Use the \f[CI]+empty_paragraphs\f[I] extension
435−Ignore paragraphs with non content.
437+instead.\f[] Ignore paragraphs with no content.
436This option is useful for converting word processing documents where
438This option is useful for converting word processing documents where
437users have used empty paragraphs to create inter\-paragraph space.
439users have used empty paragraphs to create inter\-paragraph space.
438.RS
440.RS
@@ -1809,6 +1811,14 @@ list of options for biblatex.
1809list of options for natbib.
1811list of options for natbib.
1810.RS
1812.RS
1811.RE
1813.RE
1814+.TP
1815+.B \f[C]pagestyle\f[]
1816+An option for LaTeX\[aq]s \f[C]\\pagestyle{}\f[].
1817+The default article class supports \[aq]plain\[aq] (default),
1818+\[aq]empty\[aq], and \[aq]headings\[aq]; headings puts section titles in
1819+the header.
1820+.RS
1821+.RE
1812.SS Variables for ConTeXt
1822.SS Variables for ConTeXt
1813.TP
1823.TP
1814.B \f[C]papersize\f[]
1824.B \f[C]papersize\f[]
@@ -4752,6 +4762,13 @@ anything.
4752.IP \[bu] 2
4762.IP \[bu] 2
4753Lazy wrapping of paragraphs is not allowed: the entire definition must
4763Lazy wrapping of paragraphs is not allowed: the entire definition must
4754be indented four spaces.
4764be indented four spaces.
4765+.SS Extension: \f[C]empty_paragraphs\f[]
4766+.PP
4767+Allows empty paragraphs.
4768+By default empty paragraphs are omitted.
4769+This affects the \f[C]docx\f[] reader and writer, the
4770+\f[C]opendocument\f[] and \f[C]odt\f[] writer, and all HTML\-based
4771+readers and writers.
4755.SS Markdown variants
4772.SS Markdown variants
4756.PP
4773.PP
4757In addition to pandoc\[aq]s extended Markdown, the following Markdown
4774In addition to pandoc\[aq]s extended Markdown, the following Markdown
@@ -4811,8 +4828,9 @@ extensions on \f[C]commonmark\f[]:
4811\f[C]
4828\f[C]
4812These\ can\ all\ be\ individually\ disabled.\ Note,\ however,\ that
4829These\ can\ all\ be\ individually\ disabled.\ Note,\ however,\ that
4813`commonmark`\ and\ `gfm`\ have\ limited\ support\ for\ extensions:
4830`commonmark`\ and\ `gfm`\ have\ limited\ support\ for\ extensions:
4814−extensions\ other\ than\ those\ listed\ above\ (and\ `smart`)\ will\ have
4831+extensions\ other\ than\ those\ listed\ above\ (and\ `smart`\ and
4815−no\ effect\ on\ `commonmark`\ or\ `gfm`.
4832+`raw_tex`)\ will\ have\ no\ effect\ on\ `commonmark`\ or\ `gfm`.
4833+And\ `raw_tex`\ only\ affects\ `gfm`\ output,\ not\ input.
4816\f[]
4834\f[]
4817.fi
4835.fi
4818.SS Extensions with formats other than Markdown
4836.SS Extensions with formats other than Markdown
@@ -4833,7 +4851,8 @@ You can use pandoc to produce an HTML + JavaScript slide presentation
4833that can be viewed via a web browser.
4851that can be viewed via a web browser.
4834There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
4852There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
4835reveal.js.
4853reveal.js.
4836−You can also produce a PDF slide show using LaTeX \f[C]beamer\f[].
4854+You can also produce a PDF slide show using LaTeX \f[C]beamer\f[], or
4855+slides shows in Microsoft PowerPoint format.
4837.PP
4856.PP
4838Here\[aq]s the Markdown source for a simple slide show,
4857Here\[aq]s the Markdown source for a simple slide show,
4839\f[C]habits.txt\f[]:
4858\f[C]habits.txt\f[]:
@@ -4912,6 +4931,14 @@ pandoc\ \-t\ beamer\ habits.txt\ \-o\ habits.pdf
4912.PP
4931.PP
4913Note that a reveal.js slide show can also be converted to a PDF by
4932Note that a reveal.js slide show can also be converted to a PDF by
4914printing it to a file from the browser.
4933printing it to a file from the browser.
4934+.PP
4935+To produce a Powerpoint slide show, type
4936+.IP
4937+.nf
4938+\f[C]
4939+pandoc\ habits.txt\ \-o\ habits.pptx
4940+\f[]
4941+.fi
4915.SS Structuring the slide show
4942.SS Structuring the slide show
4916.PP
4943.PP
4917By default, the \f[I]slide level\f[] is the highest header level in the
4944By default, the \f[I]slide level\f[] is the highest header level in the