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

Annual Reviews (sorted by order of appearance)


Pensoft Journals


Annual Reviews (author-date)


The Lancet


Elsevier (numeric, with titles)


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


Royal Society of Chemistry


American Anthropological Association


SAGE - Vancouver




Frontiers journals


Elsevier - Harvard (with titles)


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


Angewandte Chemie International Edition


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


Springer - Basic (author-date)


Trends journals


American Geophysical Union


American Political Science Association


American Psychological Association 7th edition




SPIE journals


Cite Them Right 12th edition - Harvard


American Institute of Aeronautics and Astronautics


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


Copernicus Publications


SIST02 (日本語)


Springer - SocPsych (author-date)


Modern Language Association 8th edition




ISO-690 (numeric, English)


Springer - MathPhys (numeric, brackets)


Springer - Lecture Notes in Computer Science


Future Science Group


Current Opinion journals


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


American Meteorological Society


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


American Society of Civil Engineers


Chicago Manual of Style 17th edition (note)




Deutsche Sprache (Deutsch)


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


Bristol University Press


Association for Computing Machinery


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


American Medical Association 11th edition


Elsevier - Vancouver


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




Chicago Manual of Style 17th edition (full note)


Turabian 9th edition (author-date)


Springer - Fachzeitschriften Medizin Psychologie (Deutsch)


Thieme-German (Deutsch)


Taylor & Francis - National Library of Medicine


American Chemical Society


American Institute of Physics 4th edition


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


Russian GOST R 7.0.5-2008 (numeric)


Institute of Physics (numeric)


ISO-690 (author-date, English)


The Institution of Engineering and Technology


American Society for Microbiology


Multidisciplinary Digital Publishing Institute


Springer - Basic (numeric, brackets)


Springer - Humanities (author-date)


Turabian 8th edition (full note)


Karger journals


Springer - Vancouver (brackets)


Vancouver (superscript)


American Physical Society


Mary Ann Liebert - Vancouver


American Society of Mechanical Engineers


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


American Physiological Society


Future Medicine journals


BioMed Central


Public Library of Science


American Sociological Association 6th edition


Modern Language Association 9th edition



Default: "ieee"