@@ -4199,6 +4199,12 @@ or block-level formatting:
41994199 It consists of two paragraphs.
42004200 ...
42014201
4202+The literal block after the `|` must be indented relative to the
4203+line containing the `|`. If it is not, the YAML will be invalid
4204+and pandoc will not interpret it as metadata. For an overview
4205+of the complex rules governing YAML, see the [Wikipedia entry on
4206+YAML syntax].
4207+
42024208Template variables will be set automatically from the metadata. Thus, for
42034209example, in writing HTML, the variable `abstract` will be set to the HTML
42044210equivalent of the Markdown in the `abstract` field:
@@ -4261,6 +4267,7 @@ following restrictions apply:
42614267 if the link definition is somewhere else in the document.
42624268
42634269[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092
4270+[Wikipedia entry on YAML syntax]: https://en.m.wikipedia.org/wiki/YAML#Syntax
42644271
42654272## Backslash escapes
42664273