@@ -1,7 +1,7 @@
2−.\" Automatically generated by Pandoc 2.12.1
2+.\" Automatically generated by Pandoc 2.13
4−.TH "Pandoc User\[cq]s Guide" "" "March 20, 2021" "pandoc 2.13" ""
4+.TH "Pandoc User\[cq]s Guide" "" "May 13, 2021" "pandoc 2.14" ""
7pandoc - general markup converter
7pandoc - general markup converter
@@ -4880,6 +4880,21 @@ header-includes:
4880 \[ga]\[ga]\[ga]
4880 \[ga]\[ga]\[ga]
4884+Note: the \f[C]yaml_metadata_block\f[R] extension works with
4885+\f[C]commonmark\f[R] as well as \f[C]markdown\f[R] (and it is enabled by
4886+default in \f[C]gfm\f[R] and \f[C]commonmark_x\f[R]).
4887+However, in these formats the following restrictions apply:
4889+The YAML metadata block must occur at the beginning of the document (and
4890+there can be only one).
4891+If multiple files are given as arguments to pandoc, only the first can
4892+be a YAML metadata block.
4894+The leaf nodes of the YAML structure are parsed in isolation from each
4895+other and from the rest of the document.
4896+So, for example, you can\[cq]t use a reference link in these contexts if
4897+the link definition is somewhere else in the document.
4883.SS Backslash escapes
4898.SS Backslash escapes
4884.SS Extension: \f[C]all_symbols_escapable\f[R]
4899.SS Extension: \f[C]all_symbols_escapable\f[R]
@@ -6468,9 +6483,29 @@ entries (for author-date and numerical styles only).
6469\f[B]\f[CB]lang\f[B]\f[R]
6484\f[B]\f[CB]lang\f[B]\f[R]
6470The \f[C]lang\f[R] field will affect how the style is localized, for
6485The \f[C]lang\f[R] field will affect how the style is localized, for
6471−example in the translation of labels and the use of quotation marks.
6486+example in the translation of labels, the use of quotation marks, and
6487+the way items are sorted.
6472(For backwards compatibility, \f[C]locale\f[R] may be used instead of
6488(For backwards compatibility, \f[C]locale\f[R] may be used instead of
6473\f[C]lang\f[R], but this use is deprecated.)
6489\f[C]lang\f[R], but this use is deprecated.)
6492+A BCP 47 language tag is expected: for example, \f[C]en\f[R],
6493+\f[C]de\f[R], \f[C]en-US\f[R], \f[C]fr-CA\f[R], \f[C]ug-Cyrl\f[R].
6494+The unicode extension syntax (after \f[C]-u-\f[R]) may be used to
6495+specify options for collation (sorting) more precisely.
6496+Here are some examples:
6498+\f[C]zh-u-co-pinyin\f[R] \[en] Chinese with the Pinyin collation.
6500+\f[C]es-u-co-trad\f[R] \[en] Spanish with the traditional collation
6501+(with \f[C]Ch\f[R] sorting after \f[C]C\f[R]).
6503+\f[C]fr-u-kb\f[R] \[en] French with \[lq]backwards\[rq] accent sorting
6504+(with \f[C]cot\['e]\f[R] sorting after \f[C]c\[^o]te\f[R]).
6506+\f[C]en-US-u-kf-upper\f[R] \[en] English with uppercase letters sorting
6507+before lower (default is lower before upper).
6475\f[B]\f[CB]notes-after-punctuation\f[B]\f[R]
6510\f[B]\f[CB]notes-after-punctuation\f[B]\f[R]
6476If true (the default), pandoc will put footnote citations after
6511If true (the default), pandoc will put footnote citations after