full-citation — demonstration
This document demonstrates all three front-matter options of the full-citation extension. Each option is set in the YAML above; the sections below show what each one does and how they interact.
1. .full-citation div
Wrap [@citekey] in a .full-citation fenced div to render the full formatted citation in place of the div.
Entry with a URL and a PDF attachment — produces [online] and [PDF] links in HTML output:
Pštross, Karolína, Stuart Firestein, Paulo V. Almeida, and Natalia Pasternak. 2025. “Science Advice at the Top: A Global Overview of Chief Science Advisor Model in Governance.” Science and Public Policy, November 17, scaf072. https://doi.org/10.1093/scipol/scaf072. [PDF] [online]
Entry with a URL but no attached PDF — produces [online] only:
Goldfield, Gary S., Marcus V. V. Lopes, Wardah Mahboob, Sabrina Perry, and Christopher G. Davis. 2026. “Reducing Social Media Use Decreases Loneliness Regardless of Gender or Level of Social Comparisons in Youth with Anxiety and Depression: A Randomized Controlled Trial.” Journal of Affective Disorders 403 (February): 121331. https://doi.org/10.1016/j.jad.2026.121331.
Entry with a PDF attachment but no URL — produces [PDF] only:
Schillemans, Thomas. n.d. Struggling Out of the Garbage Can. [PDF]
2. ref= attribute
Use ref= when you do not want a cite key inside the div body. The key must be known to citeproc — here nocite: "@*" in the front matter covers it.
Asirvatham, Hemanth, Elliott Mokski, and Andrei Shleifer. 2026. “GPT as a Measurement Tool.” Working Paper 34834. Pre-published February. https://doi.org/10.3386/w34834. [PDF] [online]
Impact of Human Resource Management: An Evidence Review. n.d. https://www.cipd.org/en/knowledge/evidence-reviews/impact-hr-management/. [PDF] [online]
3. full-citation-all
With the current setting (full-citation-all: false), a regular inline citation like (Simon 1998) renders as a short author-date string.
Change the option to full-citation-all: true and every [@key] in the document — including the one in the sentence above — is automatically expanded to a full inline citation. No .full-citation div is needed. This is useful for syllabi or reading lists where all references should appear in long form.
.full-citation divs and full-citation-all: true can be combined freely; divs are processed first and take precedence.
4. full-citation-suppress-bibliography
Pandoc normally appends a complete reference list at the end of the document. This example sets full-citation-suppress-bibliography: true, so no such list appears below this section.
Change it to false and re-render to see the trailing list.
Note: Do not use Pandoc’s own
suppress-bibliography: true— that disables citeproc internally and prevents the extension from building its citation map.
5. full-citation-attachments
When full-citation-attachments: true (the default), the extension reads the file field of each bib entry, copies any PDF to a {bib-name}-attachments/ subdirectory next to the HTML output, and appends a [PDF] link after the formatted citation.
The entries in sections 1 and 2 above illustrate this. Set full-citation-attachments: false to disable PDF copying and [PDF] links while keeping [online] links.
Common option combinations
suppress-bibliography |
attachments |
full-citation-all |
Typical use case |
|---|---|---|---|
true |
true |
false |
Annotated bibliography with PDF links |
true |
false |
true |
Syllabus — every [@key] expands inline |
false |
true |
false |
Reading list — inline divs + trailing ref list |
true |
false |
false |
Clean HTML without PDFs or trailing list |