quarto-touying-typst

Render License: MIT

A drop-in Quarto extension for building slides with Touying, the Beamer-like presentation framework for Typst. It wires Quarto’s slide syntax onto Touying and lets you pick any built-in Touying theme – or bring your own.

The metropolis title slide rendered with this extension

The metropolis title slide rendered with this extension

Install

quarto add kazuyanagimoto/quarto-touying-typst

Or start from the template:

quarto use template kazuyanagimoto/quarto-touying-typst

Usage

---
title: My Talk
subtitle: A subtitle
format: touying-typst
theme: metropolis
author:
  - name: Your Name
    affiliations: Your Institution
date: today
---
# A Section

## A Slide

Content goes here.

# starts a new section and ## starts a new slide, mirroring Touying’s native = / ==.

Themes and options

Option Default Description
theme default Built-in theme to use
aspect-ratio 16-9 Slide aspect ratio (16-9, 4-3)
handout false Collapse incremental reveals into a handout

Seven themes ship in the box: default, simple, metropolis, dewdrop, university, aqua, and stargazer. Colours are tuned with accent / accent2 / jet, fonts with mainfont / sansfont / monofont, or a Quarto brand. A theme’s own extra knobs (font sizes, weights, …) are set on the theme function with .with(...).

Custom and external themes work too: any Touying theme, one you wrote or one from Typst Universe – including the styled clean theme – via include-in-header plus a theme-typst option. Keeping styled themes external means the base stays independent of any theme package’s pinned Touying version.

What you can do

  • Pauses (. . .), incremental lists, and multi-step reveals (.only / .uncover / .complex-anim)
  • Side-by-side .columns
  • Emphasis classes: .alert, .fg, .bg, .button, .small-cite
  • Shortcodes: {{< pause >}}, {{< meanwhile >}}, {{< appendix >}}
  • Map any span or div to a Typst function with commands: / environments:
  • Everything standard Quarto + Typst: equations, code, tables, figures

See the Tutorial for a full walkthrough, and the Gallery to flip through every theme in the browser.

Relationship to other extensions

  • This extension is the Touying counterpart to projector (which targets Polylux).
  • The styled clean theme lives in its own package, touying-quarto-clean (source: quarto-clean-typst), and rides on this base through the external-theme path – the intended pattern for styled theme repos.