Tables, equations, and bibliography

Tables

Choose Document → Insert table… to build a table and inspect the generated source before inserting it.

For a small table, you can also type:

#table(
  columns: (1fr, 1fr),
  table.header([Observation], [Count]),
  [Morning], [12],
  [Afternoon], [18],
)

Equations

Use dollar signs for math. Spaces just inside the delimiters make a displayed equation:

The energy is $E = m c^2$.

$ sum_(i=1)^n i = (n(n+1))/2 $

Use Document → Insert symbol… when you need help finding a symbol. The Typst math reference explains the language in more detail.

Bibliography

For a first citation from your account library, type @ and choose Choose from My library…. Select a reference, keep Add bibliography to this document checked when offered, then review and choose Add and cite. See Your reference library for the full flow.

You can also upload a bibliography file such as references.bib, then choose Document → Insert bibliography… or insert:

#bibliography("references.bib")

Find and insert citations

Choose Document → Cite…. On a phone, open the menu button and find Cite… in the Document section. Use In this project to search project files. Search by title, author, year, or citation key. Select one or more results, then choose Insert citation or Insert citations. Each result shows its source file so you can distinguish similar entries.

Use Source file to narrow the results. Files marked referenced in document were found in literal bibliography calls reachable from the current compile target. Templates, computed paths, and conditional code can make setup uncertain. If Tylor cannot identify the selected source in your document, it asks you to confirm that you have included it. The In this project flow does not insert a bibliography declaration or change your template. Use Document → Insert bibliography… for that separate setup step when needed.

Open Citation options for a supplement such as p. 12, or enable Use prose form to put the author in the sentence. A supplement applies to every selected citation and is inserted as literal text, not executable Typst markup. The source preview shows exactly what will be inserted. To give different page references to different works, insert them separately.

Search keeps your selections when you change the query. Use the selected-reference controls or Clear selection to remove them. Keyboard users can press Down from search to focus the first result, move between results with Up/Down, and use Space to select. Tab reaches the remaining controls; Escape closes the dialog. There is no dedicated Cite keyboard shortcut.

After insertion, focus returns to the editor. Normal Undo removes the citation. When needed, Cite uses explicit #cite(...) syntax so following text cannot become part of the citation key. If the insertion point is deleted or you change documents while Cite is open, close the dialog and reopen it at the intended position. Read-only documents allow search but not insertion.

You can also type @ in document text for completion. Bibliography candidates include title, authors and date when available; section and figure labels remain in the same list. Use Ctrl+Space to request completion explicitly. In an editable server document, Choose from My library… is available even before the document has a bibliography. Keys must match a bibliography entry; missing keys still produce a compiler diagnostic.

Files, offline use, and limitations

• Search supports BibTeX .bib and Hayagriva .yml / .yaml, including UTF-8 files imported as binary data. Plain YAML configuration without bibliography entries does not become a reference.
• Indexing runs in a background worker. The dialog displays up to 80 results at a time; narrow the query to find more. Sources above the 5 MB indexing limit remain editable and compilable, but are not indexed for search. Source notices explain unreadable or unsupported input.
• Duplicate keys are marked. Resolve duplicate definitions in the bibliographies used by the document before inserting; choosing a search result cannot tell Typst which duplicate to use.
• Search metadata is a convenience, not the final citation rendering. BibTeX LaTeX commands may remain visible, and inherited crossref/xdata fields are not expanded in the index. Original entries are preserved; the Typst compiler remains responsible for the rendered bibliography.
• Project reference search and insertion work without an account and offline once Tylor and its compiler have loaded. They do not add, delete, reformat or automatically update bibliography files.
• My library copies selected account references into an independent document BibTeX file before citing. See Your reference library. Exact DOI lookup is available in the library; publisher-URL lookup is available on configured servers, and Zotero synchronization remains planned.

Table of contents

Choose Document → Insert table of contents…, or use #outline() to list your document’s headings. Use =, ==, and === for successive heading levels.

The insertion tools generate source you can continue editing. If your template already defines these elements, follow the template’s structure before adding a second copy.

Manage reusable BibTeX records in Account menu → My library. See Your reference library for reviewed imports, updates and exports.