citations
When the citations extension is enabled in org, org-cite
and org-ref style citations will be parsed as native pandoc citations.
When citations is enabled in docx, citations inserted by
Zotero or Mendeley or EndNote plugins will be parsed as native pandoc
citations. (Otherwise, the formatted citations generated by the
bibliographic software will be parsed as regular text.)
citations
To cite a bibliographic item with an identifier foo, use the syntax
@foo. Normal citations should be included in square brackets,
with semicolons separating distinct items:
Blah blah [@doe99; @smith2000; @smith2004].
How this is rendered depends on the citation style. In an author-date style, it might render as
Blah blah (Doe 1999, Smith 2000, 2004).
In a footnote style, it might render as
Blah blah.[^1] [^1]: John Doe, "Frogs," *Journal of Amphibians* 44 (1999); Susan Smith, "Flies," *Journal of Insects* (2000); Susan Smith, "Bees," *Journal of Insects* (2004).
See the CSL user documentation for more information about CSL styles and how they affect rendering.
Unless a citation key start with a letter, digit, or _, and
contains only alphanumerics and single internal punctuation characters
(:.#$%&-+?<>~/), it must be surrounded by curly braces, which are
not considered part of the key. In @Foo_bar.baz., the key is
Foo_bar.baz because the final period is not internal
punctuation, so it is not included in the key. In
@{Foo_bar.baz.}, the key is Foo_bar.baz., including the
final period. In @Foo_bar--baz, the key is Foo_bar
because the repeated internal punctuation characters terminate the key.
The curly braces are recommended if you use URLs as keys:
[@{https://example.com/bib?name=foobar&date=2000}, p. 33].
Citation items may optionally include a prefix, a locator, and a suffix. In
Blah blah [see @doe99, pp. 33-35 and *passim*; @smith04, chap. 1].
The first item (doe99) has prefix see, locator
pp. 33-35, and suffix and *passim*. The second item
(smith04) has locator chap. 1 and no prefix or suffix.
Pandoc uses some heuristics to separate the locator from the rest of the
subject. It is sensitive to the locator terms defined in the
CSL locale files. Either abbreviated or unabbreviated forms are accepted. In the
en-US locale, locator terms can be written in either singular or
plural forms, as book, bk./bks.; chapter,
chap./chaps.; column, col./cols.;
figure, fig./figs.; folio,
fol./fols.; number, no./nos.;
line, l./ll.; note, n./nn.;
opus, op./opp.; page, p./pp.;
paragraph, para./paras.; part,
pt./pts.; section, sec./secs.;
sub verbo, s.v./s.vv.; verse,
v./vv.; volume, vol./vols.;
¶/¶¶; §/§§. If no locator term is used,
“page” is assumed.
In complex cases, you can force something to be treated as a locator by enclosing it in curly braces or prevent parsing the suffix as locator by prepending curly braces:
[@smith{ii, A, D-Z}, with a suffix]
[@smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
[@smith{}, 99 years later]
A minus sign (-) before the @ will suppress mention of
the author in the citation. This can be useful when the author is
already mentioned in the text:
Smith says blah [-@smith04].
You can also write an author-in-text citation, by omitting the square brackets:
@smith04 says blah. @smith04 [p. 33] says blah.
This will cause the author's name to be rendered, followed by the bibliographical details. Use this form when you want to make the citation the subject of a sentence.
When you are using a note style, it is usually better to let citeproc create the footnotes from citations rather than writing an explicit note. If you do write an explicit note that contains a citation, note that normal citations will be put in parentheses, while author-in-text citations will not. For this reason, it is sometimes preferable to use the author-in-text style inside notes when using a note style.