AUTHORING

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

  1. Put a BibTeX file at public/references.bib — in managed mode, place references.bib in your site.assets directory.
  2. 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 ::bibliography for only the entries cited on the current page.