quarto-typst

Bridge YAML front matter to Typst templates within Quarto extensions.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/drmowinckels/dotfiles --skill quarto-typst
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarto-typst
Source: https://github.com/drmowinckels/dotfiles/tree/main/config/claude/skills/quarto-typst
Command: npx skills add https://github.com/drmowinckels/dotfiles --skill quarto-typst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Typst-based document templates integrated with Quarto extensions are difficult to organize and reuse across projects. This skill provides a structured approach to building Typst templates that work with Quarto, including multi-mode layouts and branding.

Core Features & Use Cases

  • Two-file architecture with Typst partials (typst-template.typ and typst-show.typ) to separate formatting logic from data
  • Multi-mode templates controlled by boolean flags (report, letterhead, certificate) for flexible document generation
  • Page setup, headers/footers, backgrounds, and color theming driven by brand data for consistent styling
  • Bridge between YAML front matter and Typst function parameters to enable seamless document rendering
  • Accessibility considerations and WCAG-compliant typography utilities to ensure readable output
  • Works well with quarto-extensions and other Quarto formats to support polished publication pipelines

Quick Start

Integrate the two Typst partials in your Quarto extension, then call the Typst format function with your document metadata to render a template.

Frequently Asked Questions about quarto-typst

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use Typst templates within Quarto extensions?

You use a two-file architecture with typst-template.typ and typst-show.typ partials to separate formatting logic from data, enabling configurable multi-mode documents within Quarto extensions.

Can I switch between report, letterhead, and certificate layouts in a single Quarto Typst document?

Yes, multi-mode templates are controlled by boolean flags in the YAML front matter. This bridge switches between report, letterhead, and certificate layouts seamlessly during document rendering.

How does Quarto pass YAML front matter data to Typst formatting functions?

The template bridges YAML front matter directly to Typst function parameters. This mechanism drives page setup, headers, footers, and color theming based on brand data for consistent document styling.

Does this approach support accessibility and WCAG-compliant typography in Quarto outputs?

Yes, the template includes accessibility considerations and WCAG-compliant typography utilities. These ensure readable output and accessible document generation when formatting Typst documents within Quarto.

What is the best way to organize Typst partials for reusable Quarto formatting?

The best way is using a two-file architecture with typst-template.typ and typst-show.typ partials. This separates formatting logic from data, making templates highly reusable across different Quarto projects.