TypstDocumentation

bibliographyElement
Question mark

A bibliography / reference listing.

You can create a new bibliography by calling this function with a path to a bibliography file in either one of two formats:

As soon as you add a bibliography somewhere in your document, you can start citing things with reference syntax (@key) or explicit calls to the citation function (#cite(<key>)). The bibliography will only show entries for works that were referenced in the document.

Styles

Typst offers a wide selection of built-in citation and bibliography styles. Beyond those, you can add and use custom CSL (Citation Style Language) files. Wondering which style to use? Here are some good defaults based on what discipline you're working in:

FieldsTypical Styles
Engineering, IT"ieee"
Psychology, Life Sciences"apa"
Social sciences"chicago-author-date"
Humanities"mla", "chicago-notes", "harvard-cite-them-right"
Economics"harvard-cite-them-right"
Physics"american-physics-society"

Example

This was already noted by
pirates long ago. @arrgh

Multiple sources say ...
@arrgh @netwok.

#bibliography("works.bib")
Preview

Parameters
Question mark

path
str or array
RequiredPositional
Question mark

Path(s) to Hayagriva .yml and/or BibLaTeX .bib files.

title
none or auto or content
Settable
Question mark

The title of the bibliography.

The bibliography's heading will not be numbered by default, but you can force it to be with a show-set rule: show bibliography: set heading(numbering: "1.")

Default: auto

full
bool
Settable
Question mark

Whether to include all works from the given bibliography files, even those that weren't cited in the document.

To selectively add individual cited works without showing them, you can also use the cite function with form set to none.

Default: false

style
str
Settable
Question mark

The bibliography style.

Should be either one of the built-in styles (see below) or a path to a CSL file. Some of the styles listed below appear twice, once with their full name and once with a short alias.

View options
VariantDetails
"american-anthropological-association"

American Anthropological Association

"springer-lecture-notes-in-computer-science"

Springer - Lecture Notes in Computer Science

"american-medical-association"

American Medical Association 11th edition

"sage-vancouver"

SAGE - Vancouver

"biomed-central"

BioMed Central

"american-society-of-civil-engineers"

American Society of Civil Engineers

"taylor-and-francis-chicago-author-date"

Taylor & Francis - Chicago Manual of Style (author-date)

"gb-7714-2015-note"

China National Standard GB/T 7714-2015 (note, 中文)

"american-society-for-microbiology"

American Society for Microbiology

"american-meteorological-society"

American Meteorological Society

"future-medicine"

Future Medicine journals

"bristol-university-press"

Bristol University Press

"public-library-of-science"

Public Library of Science

"pensoft"

Pensoft Journals

"american-institute-of-aeronautics-and-astronautics"

American Institute of Aeronautics and Astronautics

"mary-ann-liebert-vancouver"

Mary Ann Liebert - Vancouver

"modern-humanities-research-association"

Modern Humanities Research Association 3rd edition (note with bibliography)

"springer-socpsych-author-date"

Springer - SocPsych (author-date)

"trends"

Trends journals

"gost-r-705-2008-numeric"

Russian GOST R 7.0.5-2008 (numeric)

"american-political-science-association"

American Political Science Association

"future-science"

Future Science Group

"association-for-computing-machinery"

Association for Computing Machinery

"elsevier-harvard"

Elsevier - Harvard (with titles)

"american-chemical-society"

American Chemical Society

"cell"

Cell

"royal-society-of-chemistry"

Royal Society of Chemistry

"sist02"

SIST02 (日本語)

"gb-7714-2005-numeric"

China National Standard GB/T 7714-2005 (numeric, 中文)

"institute-of-electrical-and-electronics-engineers"

IEEE

"springer-humanities-author-date"

Springer - Humanities (author-date)

"deutsche-gesellschaft-für-psychologie"

Deutsche Gesellschaft für Psychologie 5. Auflage (Deutsch)

"springer-basic-author-date"

Springer - Basic (author-date)

"institute-of-physics-numeric"

Institute of Physics (numeric)

"vancouver"

Vancouver

"nature"

Nature

"current-opinion"

Current Opinion journals

"annual-reviews-author-date"

Annual Reviews (author-date)

"american-institute-of-physics"

American Institute of Physics 4th edition

"gb-7714-2015-numeric"

China National Standard GB/T 7714-2015 (numeric, 中文)

"the-lancet"

The Lancet

"springer-basic"

Springer - Basic (numeric, brackets)

"american-geophysical-union"

American Geophysical Union

"turabian-fullnote-8"

Turabian 8th edition (full note)

"taylor-and-francis-national-library-of-medicine"

Taylor & Francis - National Library of Medicine

"american-physiological-society"

American Physiological Society

"thieme"

Thieme-German (Deutsch)

"copernicus"

Copernicus Publications

"the-institution-of-engineering-and-technology"

The Institution of Engineering and Technology

"annual-reviews"

Annual Reviews (sorted by order of appearance)

"deutsche-sprache"

Deutsche Sprache (Deutsch)

"harvard-cite-them-right"

Cite Them Right 12th edition - Harvard

"chicago-fullnotes"

Chicago Manual of Style 17th edition (full note)

"iso-690-author-date"

ISO-690 (author-date, English)

"council-of-science-editors-author-date"

Council of Science Editors, Name-Year (author-date)

"springer-mathphys"

Springer - MathPhys (numeric, brackets)

"american-society-of-mechanical-engineers"

American Society of Mechanical Engineers

"karger"

Karger journals

"multidisciplinary-digital-publishing-institute"

Multidisciplinary Digital Publishing Institute

"american-psychological-association"

American Psychological Association 7th edition

"modern-language-association-8"

Modern Language Association 8th edition

"gb-7714-2015-author-date"

China National Standard GB/T 7714-2015 (author-date, 中文)

"springer-vancouver"

Springer - Vancouver (brackets)

"british-medical-journal"

BMJ

"turabian-author-date"

Turabian 9th edition (author-date)

"chicago-author-date"

Chicago Manual of Style 17th edition (author-date)

"associacao-brasileira-de-normas-tecnicas"

Associação Brasileira de Normas Técnicas (Português - Brasil)

"vancouver-superscript"

Vancouver (superscript)

"angewandte-chemie"

Angewandte Chemie International Edition

"elsevier-with-titles"

Elsevier (numeric, with titles)

"iso-690-numeric"

ISO-690 (numeric, English)

"modern-language-association"

Modern Language Association 9th edition

"council-of-science-editors"

Council of Science Editors, Citation-Sequence (numeric, brackets)

"spie"

SPIE journals

"springer-fachzeitschriften-medizin-psychologie"

Springer - Fachzeitschriften Medizin Psychologie (Deutsch)

"frontiers"

Frontiers journals

"american-physics-society"

American Physical Society

"american-sociological-association"

American Sociological Association 6th edition

"elsevier-vancouver"

Elsevier - Vancouver

"chicago-notes"

Chicago Manual of Style 17th edition (note)

"alphanumeric"

Alphanumeric

Default: "ieee"