From 5159d6653b0e04f03066a50794bc24195bdf81aa Mon Sep 17 00:00:00 2001 From: William Lupton Date: Thu, 19 Aug 2021 14:18:54 +0100 Subject: Clarify that each YAML block is a separate YAML document --- MANUAL.txt | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'MANUAL.txt') 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 -- cgit v1.2.3