git.iko.soy/typeable/pandoc
on master help sign in
Update man page.
commit75fa1394815d70345d6c8132e9c05dc6fd70cca0 authorJohn MacFarlane <jgm@berkeley.edu> dateMon 11 Dec 2017, 21:46 (9 years ago) parenta23c93a
1 file changed+36−9
man/pandoc.1+36−9
man/pandoc.1+36−9
@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "December 2, 2017" "pandoc 2.0.4"
2+.TH PANDOC 1 "December 8, 2017" "pandoc 2.1"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -19,8 +19,9 @@ MultiMarkdown, reStructuredText, XHTML, HTML5, LaTeX (including
1919\f[C]beamer\f[] slide shows), ConTeXt, RTF, OPML, DocBook, OpenDocument,
2020ODT, Word docx, GNU Texinfo, MediaWiki markup, DokuWiki markup, ZimWiki
2121markup, Haddock markup, EPUB (v2 or v3), FictionBook2, Textile, groff
22−man, groff ms, Emacs Org mode, AsciiDoc, InDesign ICML, TEI Simple, Muse
23−and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide shows.
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.
2425It can also produce PDF output on systems where LaTeX, ConTeXt,
2526\f[C]pdfroff\f[], \f[C]wkhtmltopdf\f[], \f[C]prince\f[], or
2627\f[C]weasyprint\f[] is installed.
@@ -286,8 +287,8 @@ e\-book), \f[C]asciidoc\f[] (AsciiDoc), \f[C]icml\f[] (InDesign ICML),
286287slide show), \f[C]slideous\f[] (Slideous HTML and JavaScript slide
287288show), \f[C]dzslides\f[] (DZSlides HTML5 + JavaScript slide show),
288289\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−(see Custom writers, below).
290+(S5 HTML and JavaScript slide show), \f[C]pptx\f[] (PowerPoint slide
291+show) or the path of a custom lua writer (see Custom writers, below).
291292(\f[C]markdown_github\f[] provides deprecated and less accurate support
292293for Github\-Flavored Markdown; please use \f[C]gfm\f[] instead, unless
293294you 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).
432433.RE
433434.TP
434435.B \f[C]\-\-strip\-empty\-paragraphs\f[]
435−Ignore paragraphs with non content.
436+\f[I]Deprecated. Use the \f[CI]+empty_paragraphs\f[I] extension
437+instead.\f[] Ignore paragraphs with no content.
436438This option is useful for converting word processing documents where
437439users have used empty paragraphs to create inter\-paragraph space.
438440.RS
@@ -1809,6 +1811,14 @@ list of options for biblatex.
18091811list of options for natbib.
18101812.RS
18111813.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
18121822.SS Variables for ConTeXt
18131823.TP
18141824.B \f[C]papersize\f[]
@@ -4752,6 +4762,13 @@ anything.
47524762.IP \[bu] 2
47534763Lazy wrapping of paragraphs is not allowed: the entire definition must
47544764be 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.
47554772.SS Markdown variants
47564773.PP
47574774In addition to pandoc\[aq]s extended Markdown, the following Markdown
@@ -4811,8 +4828,9 @@ extensions on \f[C]commonmark\f[]:
48114828\f[C]
48124829These\ can\ all\ be\ individually\ disabled.\ Note,\ however,\ that
48134830`commonmark`\ and\ `gfm`\ have\ limited\ support\ for\ extensions:
4814−extensions\ other\ than\ those\ listed\ above\ (and\ `smart`)\ will\ have
4815−no\ effect\ on\ `commonmark`\ or\ `gfm`.
4831+extensions\ other\ than\ those\ listed\ above\ (and\ `smart`\ and
4832+`raw_tex`)\ will\ have\ no\ effect\ on\ `commonmark`\ or\ `gfm`.
4833+And\ `raw_tex`\ only\ affects\ `gfm`\ output,\ not\ input.
48164834\f[]
48174835.fi
48184836.SS Extensions with formats other than Markdown
@@ -4833,7 +4851,8 @@ You can use pandoc to produce an HTML + JavaScript slide presentation
48334851that can be viewed via a web browser.
48344852There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
48354853reveal.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.
48374856.PP
48384857Here\[aq]s the Markdown source for a simple slide show,
48394858\f[C]habits.txt\f[]:
@@ -4912,6 +4931,14 @@ pandoc\ \-t\ beamer\ habits.txt\ \-o\ habits.pdf
49124931.PP
49134932Note that a reveal.js slide show can also be converted to a PDF by
49144933printing 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
49154942.SS Structuring the slide show
49164943.PP
49174944By default, the \f[I]slide level\f[] is the highest header level in the