Typst Books, Article Layout, and typst-gather

Typst is a lightning-fast typesetting system that provides a modern alternative to LaTeX.

The Typst ecosystem is thriving, and Quarto 1.9 provides first-class support for Typst packages:

Typst Books
Article layout in Typst
Bundling of Typst packages for offline rendering

Typst Books

In Quarto 1.9, a project with type book and format typst is now rendered as a single document with multiple chapters and other book content.

_quarto.yml

project:
  type: book

book:
  title: "My Book"
  author: "Jane Doe"
  chapters:
    - index.qmd
    - intro.qmd
    - summary.qmd

format: typst

All book features previously available in the LaTeX format are now available in Typst:

Parts and Chapters
Appendices
Cross-references and chapter-based numbering
Table of Contents

List-of-Figures and List-of-Tables support is coming soon.

Typst Books are implemented as Quarto Format Extensions. Typst partials define the overall book structure, while Lua filters handle the necessary AST transformations.

Quarto bundles the quarto-orange-book extension, which bundles the Typst orange-book package. Orange-book provides a textbook-style layout with colored chapter headers and sidebars.

Article Layout in Typst

Also in Quarto 1.9, all Article Layout features now work in Typst, via the Typst Marginalia package.

Specifically:

Figures, tables, code listings, and equations can be placed in the margin using the .column-margin class.
Figure, table, and code listing captions can be placed in the margin with cap-location: margin
Footnotes and citations can be displayed in the margin with reference-location: margin and citation-location: margin. When margin citations are enabled, the bibliography is suppressed.

Naturally, book and article layout can be combined:

`typst-gather`

Quarto 1.9 automatically stages Typst packages — from your extensions, from Quarto’s bundled extensions, and from Quarto itself — into the .quarto/ cache directory before calling typst compile. This means Typst documents render offline without needing network access.

To make this work, extension authors use the new typst-gather tool, which scans their .typ files for @preview imports and downloads the packages into the extension directory. Authors run quarto call typst-gather and commit the results — users of the extension don’t need to do anything.

This means Custom Typst Formats can depend on Typst packages without copying and pasting Typst code, making them simpler and easier to maintain.