@@ -116,17 +116,18 @@ To produce a PDF, specify an output file with a `.pdf` extension:
116116
117117By default, pandoc will use LaTeX to create the PDF, which requires
118118that a LaTeX engine be installed (see `--pdf-engine` below).
119−
120−Alternatively, pandoc can use [ConTeXt], `pdfroff`, or any of the
121−following HTML/CSS-to-PDF-engines, to create a PDF: [`wkhtmltopdf`],
122−[`weasyprint`] or [`prince`].
123−To do this, specify an output file with a `.pdf` extension, as before,
124−but add the `--pdf-engine` option or `-t context`, `-t html`, or `-t ms`
125−to the command line (`-t html` defaults to `--pdf-engine=wkhtmltopdf`).
126−
127−PDF output uses [variables for LaTeX] (with a LaTeX engine);
128−[variables for ConTeXt] (with ConTeXt); or [variables for `wkhtmltopdf`]
129−(an HTML/CSS-to-PDF engine; `--css` also affects the output).
119+Alternatively, pandoc can use ConTeXt, roff ms, or HTML as an
120+intermediate format. To do this, specify an output file with a
121+`.pdf` extension, as before, but add the `--pdf-engine` option
122+or `-t context`, `-t html`, or `-t ms` to the command line.
123+The tool used to generate the PDF from the intermediate format
124+may be specified using `--pdf-engine`.
125+
126+You can control the PDF style using variables, depending on
127+the intermediate format used: see [variables for LaTeX],
128+[variables for ConTeXt], [variables for `wkhtmltopdf`],
129+[variables for ms]. When HTML is used as an intermediate
130+format, the output can be styled using `--css`.
130131
131132To debug the PDF creation, it can be useful to look at the intermediate
132133representation: instead of `-o test.pdf`, use for example `-s -o test.tex`
@@ -1249,8 +1250,16 @@ header when requesting a document from a URL:
12491250: Use the specified engine when producing PDF output.
12501251 Valid values are `pdflatex`, `lualatex`, `xelatex`, `latexmk`,
12511252 `tectonic`, `wkhtmltopdf`, `weasyprint`, `prince`, `context`,
1252− and `pdfroff`. The default is `pdflatex`. If the engine is
1253− not in your PATH, the full path of the engine may be specified here.
1253+ and `pdfroff`. If the engine is not in your PATH, the full
1254+ path of the engine may be specified here. If this option
1255+ is not specified, pandoc uses the following defaults
1256+ depending on the output format specified using `-t/--to`:
1257+
1258+ - `-t latex` or none: `pdflatex` (other options: `xelatex`, `lualatex`,
1259+ `tectonic`, `latexmk`)
1260+ - `-t context`: `context`
1261+ - `-t html`: `wkhtmltopdf` (other options: `prince`, `weasyprint`)
1262+ - `-t ms`: `pdfroff`
12541263
12551264`--pdf-engine-opt=`*STRING*
12561265