@@ -1396,7 +1396,8 @@ Metadata variables
1396: allow identification of basic aspects of the document. Included
1396: allow identification of basic aspects of the document. Included
1397 in PDF metadata through LaTeX and ConTeXt. These can be set
1397 in PDF metadata through LaTeX and ConTeXt. These can be set
1398 through a [pandoc title block][Extension: `pandoc_title_block`],
1398 through a [pandoc title block][Extension: `pandoc_title_block`],
1399− which allows for multiple authors, or through a YAML metadata block:
1399+ which allows for multiple authors, or through a
1400+ [YAML metadata block][Extension: `yaml_metadata_block`]:
@@ -1435,7 +1436,7 @@ Metadata variables
1435Additionally,
1436Additionally,
1436any root-level string metadata, not included in ODT, docx
1437any root-level string metadata, not included in ODT, docx
1437or pptx metadata is added as a *custom property*.
1438or pptx metadata is added as a *custom property*.
1438−The following YAML metadata block for instance:
1439+The following [YAML] metadata block for instance:
1441 title: 'This is the title'
1442 title: 'This is the title'
@@ -3345,7 +3346,7 @@ will also have "Version 4.0" in the header.
3346#### Extension: `yaml_metadata_block` ####
3347#### Extension: `yaml_metadata_block` ####
3348−A YAML metadata block is a valid YAML object, delimited by a line of three
3349+A [YAML] metadata block is a valid YAML object, delimited by a line of three
3349hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
3350hyphens (`---`) at the top and a line of three hyphens (`---`) or three dots
3350(`...`) at the bottom. A YAML metadata block may occur anywhere in the
3351(`...`) at the bottom. A YAML metadata block may occur anywhere in the
3351document, but if it is not at the beginning, it must be preceded by a blank
3352document, but if it is not at the beginning, it must be preceded by a blank
@@ -3377,7 +3378,7 @@ a YAML metadata block will be produced only if the `-s/--standalone`
3377option is used. All of the metadata will appear in a single block
3378option is used. All of the metadata will appear in a single block
3378at the beginning of the document.
3379at the beginning of the document.
3380−Note that YAML escaping rules must be followed. Thus, for example,
3381+Note that [YAML] escaping rules must be followed. Thus, for example,
3381if a title contains a colon, it must be quoted. The pipe character
3382if a title contains a colon, it must be quoted. The pipe character
3382(`|`) can be used to begin an indented block that will be interpreted
3383(`|`) can be used to begin an indented block that will be interpreted
3383literally, without need for escaping. This form is necessary
3384literally, without need for escaping. This form is necessary
@@ -5343,3 +5344,4 @@ warranty notices.) For a full list of contributors, see the file
5343AUTHORS.md in the pandoc source code.
5344AUTHORS.md in the pandoc source code.
5345[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
5346[GPL]: http://www.gnu.org/copyleft/gpl.html "GNU General Public License"
5347+[YAML]: https://yaml.org/spec/1.2/spec.html "YAML v1.2 Spec"