aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWilliam Lupton <wlupton@broadband-forum.org>2021-08-19 14:18:54 +0100
committerJohn MacFarlane <jgm@berkeley.edu>2021-08-19 10:37:24 -0700
commit5159d6653b0e04f03066a50794bc24195bdf81aa (patch)
treed230fd6dc8a186e1d5e8274e929b31947b0f9f6e
parent5616d00d09d3a940364befd380dde328c6ac1a08 (diff)
downloadpandoc-5159d6653b0e04f03066a50794bc24195bdf81aa.tar.gz
Clarify that each YAML block is a separate YAML document
-rw-r--r--MANUAL.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 877021cd8..c94b69289 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -4179,6 +4179,10 @@ A document may contain multiple metadata blocks. If two
metadata blocks attempt to set the same field, the value from
the second block will be taken.
+Each metadata block is handled internally as an independent YAML document.
+This means, for example, that any YAML anchors defined in a block cannot be
+referenced in another block.
+
When pandoc is used with `-t markdown` to create a Markdown document,
a YAML metadata block will be produced only if the `-s/--standalone`
option is used. All of the metadata will appear in a single block