cusomizing-pandoc.md: streamline template text

This commit is contained in:
Mauro Bieg 2018-11-17 14:39:26 +01:00 committed by GitHub
parent 0466c0a8b0
commit f07ae68558
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -21,20 +21,12 @@ Pandoc comes with a default template for (almost) every output
format. A template is a plain text file containing variables
that are replaced by text generated by pandoc. For example,
the variable `$body$` will be replaced by the document body,
and `$title$` by the title from metadata. Variables will
be automatically populated by the contents of like-named
metadata fields (with proper escaping). (See
[YAML metadata blocks](/MANUAL.html#extension-yaml_metadata_block)
for documentation on setting metafields in pandoc markdown
documents; the command line option
[`--metadata`](/MANUAL.html#option--metadata) can also be
used.) Values for variables can also be specified directly
from the command line using `--variable` (which does no escaping).
and `$title$` by the title from metadata.
To look at the default template for an output format, you can do
`pandoc -D FORMAT`, where `FORMAT` is replaced by the name of
the format. You can also replace the defaults with your
own custom templates, either by using the `--template` option
the format. For example `pandoc -D latex`. You can also use your
own template instead, either by using the `--template` option
or by putting the custom template in your user data directory
(on linux and macOS, `~/.pandoc/templates/`).