@@ -1953,6 +1953,11 @@ A document may contain multiple metadata blocks. The metadata fields will
1953be combined through a *left-biased union*: if two metadata blocks attempt
1953be combined through a *left-biased union*: if two metadata blocks attempt
1954to set the same field, the value from the first block will be taken.
1954to set the same field, the value from the first block will be taken.
1956+When pandoc is used with `-t markdown` to create a markdown document,
1957+a YAML metadata block will be produced only if the `-s/--standalone`
1958+option is used. All of the metadata will appear in a single block
1959+at the beginning of the document.
1956Note that YAML escaping rules must be followed. Thus, for example,
1961Note that YAML escaping rules must be followed. Thus, for example,
1957if a title contains a colon, it must be quoted. The pipe character
1962if a title contains a colon, it must be quoted. The pipe character
1958(`|`) can be used to begin an indented block that will be interpreted
1963(`|`) can be used to begin an indented block that will be interpreted