@@ -4177,10 +4177,12 @@ option is used. All of the metadata will appear in a single block
41774177at the beginning of the document.
41784178
41794179Note that [YAML] escaping rules must be followed. Thus, for example,
4180−if a title contains a colon, it must be quoted. The pipe character
4181−(`|`) can be used to begin an indented block that will be interpreted
4182−literally, without need for escaping. This form is necessary
4183−when the field contains blank lines or block-level formatting:
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
4183+an indented block that will be interpreted literally, without need for
4184+escaping. This form is necessary when the field contains blank lines
4185+or block-level formatting:
41844186
41854187 ---
41864188 title: 'This is the title: it contains a colon'
@@ -4255,6 +4257,7 @@ following restrictions apply:
42554257 example, you can't use a reference link in these contexts
42564258 if the link definition is somewhere else in the document.
42574259
4260+[YAML escape sequence]: https://yaml.org/spec/1.2/spec.html#id2776092
42584261
42594262## Backslash escapes
42604263