@@ -4177,10 +4177,12 @@ option is used. All of the metadata will appear in a single block
4177at the beginning of the document.
4177at the beginning of the document.
4179Note that [YAML] escaping rules must be followed. Thus, for example,
4179Note that [YAML] escaping rules must be followed. Thus, for example,
4180−if a title contains a colon, it must be quoted. The pipe character
4180+if a title contains a colon, it must be quoted, and if it contains a
4181+backslash escape, then it must be ensured that it is not treated as a
4182+[YAML escape sequence]. The pipe character (`|`) can be used to begin
4181−(`|`) can be used to begin an indented block that will be interpreted
4183+an indented block that will be interpreted literally, without need for
4182−literally, without need for escaping. This form is necessary
4184+escaping. This form is necessary when the field contains blank lines
4183−when the field contains blank lines or block-level formatting:
4185+or block-level formatting:
4186 title: 'This is the title: it contains a colon'
4188 title: 'This is the title: it contains a colon'
@@ -4255,6 +4257,7 @@ following restrictions apply:
4255 example, you can't use a reference link in these contexts
4257 example, you can't use a reference link in these contexts
4256 if the link definition is somewhere else in the document.
4258 if the link definition is somewhere else in the document.
4260+[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092
4259## Backslash escapes
4262## Backslash escapes