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.


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"


This was already noted by
pirates long ago. @arrgh

Multiple sources say ...
@arrgh @netwok.


Question mark

str or array
Question mark

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

none or auto or content
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

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

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

American Anthropological Association


Springer - Lecture Notes in Computer Science


American Medical Association 11th edition


SAGE - Vancouver


BioMed Central


American Society of Civil Engineers


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


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


American Society for Microbiology


American Meteorological Society


Future Medicine journals


Bristol University Press


Public Library of Science


Pensoft Journals


American Institute of Aeronautics and Astronautics


Mary Ann Liebert - Vancouver


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


Springer - SocPsych (author-date)


Trends journals


Russian GOST R 7.0.5-2008 (numeric)


American Political Science Association


Future Science Group


Association for Computing Machinery


Elsevier - Harvard (with titles)


American Chemical Society




Royal Society of Chemistry


SIST02 (日本語)


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




Springer - Humanities (author-date)


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


Springer - Basic (author-date)


Institute of Physics (numeric)






Current Opinion journals


Annual Reviews (author-date)


American Institute of Physics 4th edition


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


The Lancet


Springer - Basic (numeric, brackets)


American Geophysical Union


Turabian 8th edition (full note)


Taylor & Francis - National Library of Medicine


American Physiological Society


Thieme-German (Deutsch)


Copernicus Publications


The Institution of Engineering and Technology


Annual Reviews (sorted by order of appearance)


Deutsche Sprache (Deutsch)


Cite Them Right 12th edition - Harvard


Chicago Manual of Style 17th edition (full note)


ISO-690 (author-date, English)


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


Springer - MathPhys (numeric, brackets)


American Society of Mechanical Engineers


Karger journals


Multidisciplinary Digital Publishing Institute


American Psychological Association 7th edition


Modern Language Association 8th edition


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


Springer - Vancouver (brackets)




Turabian 9th edition (author-date)


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


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


Vancouver (superscript)


Angewandte Chemie International Edition


Elsevier (numeric, with titles)


ISO-690 (numeric, English)


Modern Language Association 9th edition


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


SPIE journals


Springer - Fachzeitschriften Medizin Psychologie (Deutsch)


Frontiers journals


American Physical Society


American Sociological Association 6th edition


Elsevier - Vancouver


Chicago Manual of Style 17th edition (note)



Default: "ieee"