Tissevert/pandoc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

customizing-templates.md: variable options table

Browse source
This commit is contained in:
Mauro Bieg 2018-11-17 14:23:49 +01:00 • committed by GitHub
parent d532eb14eb
commit 0466c0a8b0
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
doc/customizing-pandoc.md
View file

@ -39,8 +39,27 @@ or by putting the custom template in your user data directory
(on linux and macOS, `~/.pandoc/templates/`).
Note that in many cases you can avoid the need for a custom
template by making use of the `--include-in-header`,
`--include-before-body`, and `--include-after-body` options.
template by including a file with the `--include-in-header`,
`--include-before-body`, or `--include-after-body` option.
Or you can set the corresponding template variable directly.
### Template variables
There are several ways to set template variables:
| | [`--variable`] | [`--metadata`] | [YAML metadata] and [`--metadata-file`] |
|:---------------|:------------------|:------------------|:----------------------------|
| values can be… | strings and bools | strings and bools | also YAML objects and lists |
| strings are… | inserted verbatim | escaped | interpreted as markdown |
| accessible by filters: | no | yes | yes |
[`--variable`]: http://pandoc.org/MANUAL.html#option--variable
[`--metadata`]: http://pandoc.org/MANUAL.html#option--metadata
[YAML metadata]: http://pandoc.org/MANUAL.html#extension-yaml_metadata_block
[`--metadata-file`]: http://pandoc.org/MANUAL.html#option--metadata-file
For more information, see [Templates](/MANUAL.html#templates) in
the pandoc manual.