@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "March 2, 2019" "pandoc 2.7"
2+.TH PANDOC 1 "March 12, 2019" "pandoc 2.7.1"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -711,10 +711,16 @@ If no \f[I]VAL\f[R] is specified, the key will be given the value
711711Print the system default template for an output \f[I]FORMAT\f[R].
712712(See \f[C]-t\f[R] for a list of possible \f[I]FORMAT\f[R]s.) Templates
713713in the user data directory are ignored.
714+This option may be used with \f[C]-o\f[R]/\f[C]--output\f[R] to redirect
715+output to a file, but \f[C]-o\f[R]/\f[C]--output\f[R] must come before
716+\f[C]--print-default-template\f[R] on the command line.
714717.TP
715718.B \f[C]--print-default-data-file=\f[R]\f[I]FILE\f[R]
716719Print a system default data file.
717720Files in the user data directory are ignored.
721+This option may be used with \f[C]-o\f[R]/\f[C]--output\f[R] to redirect
722+output to a file, but \f[C]-o\f[R]/\f[C]--output\f[R] must come before
723+\f[C]--print-default-data-file\f[R] on the command line.
718724.TP
719725.B \f[C]--eol=crlf\f[R]|\f[C]lf\f[R]|\f[C]native\f[R]
720726Manually specify line endings: \f[C]crlf\f[R] (Windows), \f[C]lf\f[R]
@@ -797,6 +803,9 @@ To generate the JSON version of an existing style, use
797803Prints a JSON version of a highlighting style, which can be modified,
798804saved with a \f[C].theme\f[R] extension, and used with
799805\f[C]--highlight-style\f[R].
806+This option may be used with \f[C]-o\f[R]/\f[C]--output\f[R] to redirect
807+output to a file, but \f[C]-o\f[R]/\f[C]--output\f[R] must come before
808+\f[C]--print-highlight-style\f[R] on the command line.
800809.TP
801810.B \f[C]--syntax-definition=\f[R]\f[I]FILE\f[R]
802811Instructs pandoc to load a KDE XML syntax definition file, which will be
@@ -1034,7 +1043,7 @@ If this is not found either, sensible defaults will be used.
10341043.PP
10351044To produce a custom \f[C]reference.docx\f[R], first get a copy of the
10361045default \f[C]reference.docx\f[R]:
1037−\f[C]pandoc --print-default-data-file reference.docx > custom-reference.docx\f[R].
1046+\f[C]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
10381047Then open \f[C]custom-reference.docx\f[R] in Word, modify the styles as
10391048you wish, and save the file.
10401049For best results, do not make changes to this file other than modifying
@@ -1130,7 +1139,7 @@ If this is not found either, sensible defaults will be used.
11301139.PP
11311140To produce a custom \f[C]reference.odt\f[R], first get a copy of the
11321141default \f[C]reference.odt\f[R]:
1133−\f[C]pandoc --print-default-data-file reference.odt > custom-reference.odt\f[R].
1142+\f[C]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
11341143Then open \f[C]custom-reference.odt\f[R] in LibreOffice, modify the
11351144styles as you wish, and save the file.
11361145.RE
@@ -1158,7 +1167,7 @@ these criteria.
11581167check.)
11591168.PP
11601169You can also modify the default \f[C]reference.pptx\f[R]: first run
1161−\f[C]pandoc --print-default-data-file reference.pptx > custom-reference.pptx\f[R],
1170+\f[C]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
11621171and then modify \f[C]custom-reference.pptx\f[R] in MS PowerPoint (pandoc
11631172will use the first four layout slides, as mentioned above).
11641173.RE
@@ -1269,9 +1278,9 @@ The default is \f[C]best\f[R].
12691278.B \f[C]--pdf-engine=\f[R]\f[I]PROGRAM\f[R]
12701279Use the specified engine when producing PDF output.
12711280Valid values are \f[C]pdflatex\f[R], \f[C]lualatex\f[R],
1272−\f[C]xelatex\f[R], \f[C]latexmk\f[R], \f[C]wkhtmltopdf\f[R],
1273−\f[C]weasyprint\f[R], \f[C]prince\f[R], \f[C]context\f[R], and
1274−\f[C]pdfroff\f[R].
1281+\f[C]xelatex\f[R], \f[C]latexmk\f[R], \f[C]tectonic\f[R],
1282+\f[C]wkhtmltopdf\f[R], \f[C]weasyprint\f[R], \f[C]prince\f[R],
1283+\f[C]context\f[R], and \f[C]pdfroff\f[R].
12751284The default is \f[C]pdflatex\f[R].
12761285If the engine is not in your PATH, the full path of the engine may be
12771286specified here.
@@ -5934,6 +5943,17 @@ hello
59345943::::::
59355944\f[R]
59365945.fi
5946+.PP
5947+If you include raw HTML or TeX in an output cell, use the [raw
5948+attribute][Extension: \f[C]fenced_attribute\f[R]], as shown in the last
5949+cell of the example above.
5950+Although pandoc can process \[dq]bare\[dq] raw HTML and TeX, the result
5951+is often interspersed raw elements and normal textual elements, and in
5952+an output cell pandoc expects a single, connected raw block.
5953+To avoid using raw HTML or TeX except when marked explicitly using raw
5954+attributes, we recommend specifying the extensions
5955+\f[C]-raw_html-raw_tex+raw_attribute\f[R] when translating between
5956+Markdown and ipynb notebooks.
59375957.SH SYNTAX HIGHLIGHTING
59385958.PP
59395959Pandoc will automatically highlight syntax in fenced code blocks that