Citations
Cite references with @key syntax and render bibliographies.
Citations
Cite works with Pandoc/Quarto syntax: @key inline, or grouped in brackets.
For example, the transformer architecture [vaswani2017] trained with Adam
[kingma2015]; [he2016] reshaped the field.
The transformer architecture @vaswani2017 trained with
Adam [@kingma2015; @he2016] reshaped the field.
Each citation renders as a link to that entry on the references page. Keys may
contain hyphens and underscores (@van-der-waals2020). Citations are not
recognized inside code (@notakey here: @notakey) or email addresses
([email protected] stays literal).
Setting up the bibliography
- Put a BibTeX file at
public/references.bib— in managed mode, placereferences.bibin yoursite.assetsdirectory. - Add a references page at the content root, e.g.
references.md:
---
title: References
---
# References
::full-bibliography
::
The references page of this site is built exactly this way.
Components
The syntax is sugar over two MDC components you can also use directly:
:docyard-cite{bib="vaswani2017"}— inline citation (multiple keys:bib="a b").::full-bibliography— the full bibliography, or::bibliographyfor only the entries cited on the current page.