@@ -3021,8 +3021,8 @@ In order to use this feature, you will need to specify a bibliography file
30213021using the `bibliography` metadata field in a YAML metadata section, or
30223022`--bibliography` command line argument. You can supply multiple `--bibliography`
30233023arguments or set `bibliography` metadata field to YAML array, if you want to
3024−use multiple bibliography files.
3025−The bibliography may have any of these formats:
3024+use multiple bibliography files. The bibliography may have any of these
3025+formats:
30263026
30273027 Format File extension
30283028 ------------ --------------
@@ -3068,7 +3068,8 @@ a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown; and in CSL JSO
30683068`pandoc-citeproc -j` and `-y` interconvert the CSL JSON
30693069and CSL YAML formats as far as possible.
30703070
3071−As an alternative to specifying a bibliography file, you can include
3071+As an alternative to specifying a bibliography file using `--bibliography`
3072+or the YAML metadata field `bibliography`, you can include
30723073the citation data directly in the `references` field of the
30733074document's YAML metadata. The field should contain an array of
30743075YAML-encoded references, for example:
@@ -3108,6 +3109,9 @@ These files are specified using the `--csl` option or the `csl` metadata field.
31083109By default, `pandoc-citeproc` will use the [Chicago Manual of Style] author-date
31093110format. The CSL project provides further information on [finding and editing styles].
31103111
3112+To make your citations hyperlinks to the corresponding bibliography
3113+entries, add `link-citations: true` to your YAML metadata.
3114+
31113115Citations go inside square brackets and are separated by semicolons.
31123116Each citation must have a key, composed of '@' + the citation
31133117identifier from the database, and may optionally have a prefix,
@@ -3177,12 +3181,15 @@ outlined above, and add `--natbib` or `--biblatex` argument to `pandoc`
31773181invocation. Bear in mind that bibliography files have to be in respective
31783182format (either BibTeX or BibLaTeX).
31793183
3184+For more information, see the [pandoc-citeproc man page].
3185+
31803186[CSL markup specs]: http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields
31813187[Chicago Manual of Style]: http://chicagomanualofstyle.org
31823188[Citation Style Language]: http://citationstyles.org
31833189[Zotero Style Repository]: https://www.zotero.org/styles
31843190[finding and editing styles]: http://citationstyles.org/styles/
31853191[CSL locale files]: https://github.com/citation-style-language/locales
3192+[pandoc-citeproc man page]: https://github.com/jgm/pandoc-citeproc/blob/master/man/pandoc-citeproc.1.md
31863193
31873194Non-pandoc extensions
31883195---------------------