@@ -1,5 +1,5 @@
2−.TH PANDOC 1 "October 26, 2016" "pandoc 1.18"
2+.TH PANDOC 1 "November 30, 2016" "pandoc 1.19"
4pandoc - general markup converter
4pandoc - general markup converter
5.SH SYNOPSIS
5.SH SYNOPSIS
@@ -446,7 +446,7 @@ Reading binary files (docx, odt, epub) implies \f[C]\-\-file\-scope\f[].
449−.B \f[C]\-\-filter=\f[]\f[I]EXECUTABLE\f[]
449+.B \f[C]\-\-filter=\f[]\f[I]PROGRAM\f[]
450Specify an executable to be used as a filter transforming the pandoc AST
450Specify an executable to be used as a filter transforming the pandoc AST
451after the input is parsed and before the output is written.
451after the input is parsed and before the output is written.
452The executable should read JSON from stdin and write JSON to stdout.
452The executable should read JSON from stdin and write JSON to stdout.
@@ -480,12 +480,6 @@ Those who would prefer to write filters in python can use the module
480There are also pandoc filter libraries in PHP, perl, and
480There are also pandoc filter libraries in PHP, perl, and
481javascript/node.js.
481javascript/node.js.
483−If no directory is provided pandoc will look for executable or
484−non\-executable filters in the director \f[C]$DATADIR/filters\f[], and
485−then for executable filters in the user\[aq]s \f[C]PATH\f[].
486−If you want to run a script in the working directory, preface the
487−filename with \f[C]\&./\f[].
489In order of preference, pandoc will look for filters in
483In order of preference, pandoc will look for filters in
490.IP "1." 3
484.IP "1." 3
491a specified full or relative path (executable or non\-executable)
485a specified full or relative path (executable or non\-executable)
@@ -773,12 +767,13 @@ Deprecated synonym for \f[C]\-\-top\-level\-division=chapter\f[].
776−.B \f[C]\-\-top\-level\-division=[section|chapter|part]\f[]
770+.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[]
777Treat top\-level headers as the given division type in LaTeX, ConTeXt,
771Treat top\-level headers as the given division type in LaTeX, ConTeXt,
778DocBook, and TEI output.
772DocBook, and TEI output.
779The hierarchy order is part, chapter, then section; all headers are
773The hierarchy order is part, chapter, then section; all headers are
780shifted such that the top\-level header becomes the specified type.
774shifted such that the top\-level header becomes the specified type.
781−The default is \f[C]section\f[].
775+The default behavior is to determine the best division type via
776+heuristics: unless other conditions apply, \f[C]section\f[] is chosen.
782When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
777When the LaTeX document class is set to \f[C]report\f[], \f[C]book\f[],
783or \f[C]memoir\f[] (unless the \f[C]article\f[] option is specified),
778or \f[C]memoir\f[] (unless the \f[C]article\f[] option is specified),
784\f[C]chapter\f[] is implied as the setting for this option.
779\f[C]chapter\f[] is implied as the setting for this option.
@@ -2277,8 +2272,9 @@ Currently, the only output formats that uses this information are HTML
2277and LaTeX.
2272and LaTeX.
2278If highlighting is supported for your output format and language, then
2273If highlighting is supported for your output format and language, then
2279the code block above will appear highlighted, with numbered lines.
2274the code block above will appear highlighted, with numbered lines.
2280−(To see which languages are supported, do \f[C]pandoc\ \-\-version\f[].)
2275+(To see which languages are supported, type
2276+\f[C]pandoc\ \-\-list\-highlight\-languages\f[].) Otherwise, the code
2281−Otherwise, the code block above will appear as follows:
2277+block above will appear as follows:
@@ -2913,9 +2909,31 @@ The row of \f[C]=\f[]s separates the header from the table body, and can
2913be omitted for a headerless table.
2909be omitted for a headerless table.
2914The cells of grid tables may contain arbitrary block elements (multiple
2910The cells of grid tables may contain arbitrary block elements (multiple
2915paragraphs, code blocks, lists, etc.).
2911paragraphs, code blocks, lists, etc.).
2916−Alignments are not supported, nor are cells that span multiple columns
2912+Cells that span multiple columns or rows are not supported.
2918Grid tables can be created easily using Emacs table mode.
2913Grid tables can be created easily using Emacs table mode.
2915+Alignments can be specified as with pipe tables, by putting colons at
2916+the boundaries of the separator line after the header:
2920++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2921+|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
2922++==============:+:==============+:==================:+
2923+|\ Bananas\ \ \ \ \ \ \ |\ $1.34\ \ \ \ \ \ \ \ \ |\ built\-in\ wrapper\ \ \ |
2924++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2928+For headerless tables, the colons go on the top line instead:
2932++\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-+:\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-:+
2933+|\ Right\ \ \ \ \ \ \ \ \ |\ Left\ \ \ \ \ \ \ \ \ \ |\ Centered\ \ \ \ \ \ \ \ \ \ \ |
2934++\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
2919.SS Extension: \f[C]pipe_tables\f[]
2937.SS Extension: \f[C]pipe_tables\f[]
2921Pipe tables look like this:
2939Pipe tables look like this:
@@ -4898,14 +4916,16 @@ Pandoc will automatically highlight syntax in fenced code blocks that
4898are marked with a language name.
4916are marked with a language name.
4899The Haskell library highlighting\-kate is used for highlighting, which
4917The Haskell library highlighting\-kate is used for highlighting, which
4900works in HTML, Docx, and LaTeX/PDF output.
4918works in HTML, Docx, and LaTeX/PDF output.
4919+To see a list of language names that pandoc will recognize, type
4920+\f[C]pandoc\ \-\-list\-highlight\-languages\f[].
4901The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
4922The color scheme can be selected using the \f[C]\-\-highlight\-style\f[]
4903The default color scheme is \f[C]pygments\f[], which imitates the
4924The default color scheme is \f[C]pygments\f[], which imitates the
4904−default color scheme used by the Python library pygments, but pygments
4925+default color scheme used by the Python library pygments (though
4905−is not actually used to do the highlighting.
4926+pygments is not actually used to do the highlighting).
4906−.PP
4927+To see a list of highlight styles, type
4907−To see a list of language names that pandoc will recognize, type
4908−\f[C]pandoc\ \-\-version\f[].
4928+\f[C]pandoc\ \-\-list\-hightlight\-styles\f[].
4910To disable highlighting, use the \f[C]\-\-no\-highlight\f[] option.
4930To disable highlighting, use the \f[C]\-\-no\-highlight\f[] option.
4911.SH CUSTOM STYLES IN DOCX OUTPUT
4931.SH CUSTOM STYLES IN DOCX OUTPUT