A New Typst Template for Pandoc (2025)

A new Typst template for Pandoc has been released in 2025, enabling users to produce more polished PDFs from markdown with improved layout and typography controls. This development is relevant for users who rely on Pandoc and Typst for document processing, especially in academic and technical writing.

The developer, active in the markdown and typesetting community, created the template to adapt to recent updates in Typst (version 0.13) and Pandoc (version 3.6.4). The new template utilizes Pandoc’s default Typst output template, which is minimal, combined with an actual Typst template file that handles detailed formatting. Users invoke the template through a command that passes a variable to Pandoc, which then loads the Typst template for styling content such as headers, footers, fonts, and section styles.

The template supports metadata extraction from markdown files, including title, author, and date, and offers configurable options for headers, footers, fonts, and section formatting. It also includes styling for block quotations, code blocks, images, footnotes, and headings, with room for customization. The layout features a title block, justified paragraphs with first-line indents, and a simple but customizable document body. The approach aims to separate Pandoc’s logic from Typst’s styling, making workflows more robust and adaptable to future updates.

Why It Matters

This update is significant for users who generate PDFs from markdown, especially in academic, technical, and publishing contexts. By providing a flexible and maintainable template, it improves the quality and consistency of generated documents. The separation of Pandoc and Typst logic enhances long-term stability, reducing breakage when either tool updates. This development also exemplifies ongoing efforts to streamline markdown-to-PDF workflows with advanced typesetting capabilities, potentially influencing future tools and templates.

Datavideo DAC-70 Up/Down/Cross Converter

• Multiple input options: Audio, HDMI, SDI, VGA inputs
• Multiple output options: 3G/HD/SD SDI and HDMI outputs
• Rackmount compatible: Supports optional RMK-2 2RU rack mount

View Latest Price

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Background

Last summer, the same developer introduced an initial Typst template for Pandoc, but subsequent updates to Typst (up to v0.13) and Pandoc (up to v3.6.4) rendered the previous templates incompatible. This prompted a rebuild, which was completed in early 2025. The new approach leverages Pandoc’s minimal Typst output template combined with a dedicated Typst template, reflecting recent changes in both tools and emphasizing modularity and clarity. The development aligns with broader trends in document automation and typographic customization, especially among academic and technical communities.

“The new template separates Pandoc’s logic from Typst’s styling, making workflows more robust and adaptable to future updates.”

— Developer

“You can invoke the template by passing a variable to Pandoc, which then loads the Typst template for styling.”

— Developer

What Remains Unclear

It is not yet clear how widely adopted this template will become or how it will perform with complex documents. The developer notes that some features are customizable, but the full extent of its flexibility and compatibility with different workflows remains to be tested by the community. Future updates to Typst or Pandoc could still necessitate further modifications.

What’s Next

Next steps include community testing, feedback, and potential refinement of the template. The developer may release additional customization options or updated versions as new features or updates emerge in Typst and Pandoc. Monitoring user experiences will determine how the template evolves and whether it becomes a standard tool for markdown-to-PDF workflows.

Key Questions

How do I use the new Typst template with Pandoc?

You invoke it by running a command like: pandoc file.md -o file.pdf -V template=article.typ --pdf-engine=typst