@@ -743,18 +743,24 @@ Citation rendering
743743 overriding any value set in the metadata, and process citations
744744 using `pandoc-citeproc`. (This is equivalent to
745745 `--metadata bibliography=FILE --filter pandoc-citeproc`.)
746+ If `--natbib` or `--biblatex` is also supplied, `pandoc-citeproc` is not
747+ used, making this equivalent to `--metadata bibliography=FILE`.
748+ If you supply this argument multiple times, each *FILE* will be added
749+ to bibliography.
746750
747751`--csl=`*FILE*
748752
749753: Set the `csl` field in the document's metadata to *FILE*,
750754 overriding any value set in the metadata. (This is equivalent to
751755 `--metadata csl=FILE`.)
756+ This option is only relevant with `pandoc-citeproc`.
752757
753758`--citation-abbreviations=`*FILE*
754759
755760: Set the `citation-abbreviations` field in the document's metadata to
756761 *FILE*, overriding any value set in the metadata. (This is equivalent to
757762 `--metadata citation-abbreviations=FILE`.)
763+ This option is only relevant with `pandoc-citeproc`.
758764
759765`--natbib`
760766
@@ -2670,7 +2676,10 @@ citations and a bibliography in a number of styles. Basic usage is
26702676 pandoc --filter pandoc-citeproc myinput.txt
26712677
26722678In order to use this feature, you will need to specify a bibliography file
2673−using the `bibliography` metadata field in a YAML metadata section.
2679+using the `bibliography` metadata field in a YAML metadata section, or
2680+`--bibliography` command line argument. You can supply multiple `--bibliography`
2681+arguments or set `bibliography` metadata field to YAML array, if you want to
2682+use multiple bibliography files.
26742683The bibliography may have any of these formats:
26752684
26762685 Format File extension
@@ -2793,6 +2802,12 @@ In this example, the document will contain a citation for `item3`
27932802only, but the bibliography will contain entries for `item1`, `item2`, and
27942803`item3`.
27952804
2805+For LaTeX or PDF output, you can also use NatBib or BibLaTeX
2806+to render bibliography. In order to do so, specify bibliography files as
2807+outlined above, and add `--natbib` or `--biblatex` argument to `pandoc`
2808+invocation. Bear in mind that bibliography files have to be in respective
2809+format (either BibTeX or BibLaTeX).
2810+
27962811Non-pandoc extensions
27972812---------------------
27982813