TL;DR
In 2025, a developer released a new Typst template designed for Pandoc, enabling more flexible and robust PDF generation from markdown. The update addresses compatibility issues caused by recent software upgrades and introduces a more modular approach.
A new Typst template for Pandoc was released in March 2025, offering enhanced support for markdown to PDF conversion workflows. The update responds to recent upgrades in Typst (to v0.13) and Pandoc (to v3.6.4), which previously broke compatibility with earlier templates. This development matters for users seeking a more stable, customizable way to produce styled PDFs from markdown sources.
The developer behind the new template redesigned it to work with Pandoc’s default Typst output template, which itself now performs minimal formatting. The new approach involves passing a variable (-V template=article.typ) during Pandoc execution, which instructs Pandoc to import and utilize a dedicated Typst template file (article.typ). This setup separates Pandoc’s logic from Typst’s styling, making the workflow more adaptable and resilient to software updates.
The template, downloadable from the developer’s repository, processes markdown metadata such as title, author, and date, and provides customizable layout options including headers, footers, font styles, and section styling. It supports features like running heads for facing pages, typographic enhancements via OpenType features, and styled block quotes and references. The layout begins with a title block, followed by justified paragraphs with first-line indents, and concludes with a colophon crediting Typst and Pandoc.
Why It Matters
This update is significant because it restores and improves a workflow for academics, writers, and developers who rely on markdown-to-PDF conversion, especially those using Typst and Pandoc together. The modular approach enhances stability across software versions and encourages customization, potentially influencing how markdown documents are styled and formatted in academic and technical publishing.
A Modern Ebook Formatting Simplified Guide: Useful Way To Create An Ebook With An Open Source Program For Beginners And Seniors. Markdown To ePub. Template … (Save With Open Source Software 2)
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background
Last summer, the developer created a Pandoc template for Typst to facilitate styled PDF output from markdown. Since then, both Typst and Pandoc have undergone multiple updates, causing previous templates to break. The new release in 2025 addresses these issues by adopting a more compatible and flexible template system, reflecting ongoing improvements in open-source document processing tools.
“The new template uses Pandoc’s default Typst output template combined with a dedicated Typst template file, making the workflow more robust and adaptable.”
— Developer
“This setup allows users to customize layout and styles more easily, and it should remain compatible across future software versions.”
— Developer
As an affiliate, we earn on qualifying purchases.
What Remains Unclear
It is not yet clear how widely adopted this new template will become or how it will handle future updates to Typst and Pandoc beyond version 3.6.4. User feedback and real-world testing are still pending.
PDF styling templates for Pandoc
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What’s Next
Next steps include community testing, feedback collection, and potential further refinements. The developer plans to update documentation and encourage community contributions to enhance styling options and compatibility.
As an affiliate, we earn on qualifying purchases.
Key Questions
How do I use the new Typst template with Pandoc?
You run Pandoc with the command: pandoc file.md -o file.pdf -V template=article.typ --pdf-engine=typst. Ensure you have the template file downloaded and placed in your working directory.
What are the main advantages of this new template?
It offers improved stability across software updates, clearer separation of formatting logic, and greater customization options for layout and styles.
Is this template suitable for complex documents?
Yes, the template supports advanced features like headers, footers, styled sections, and custom labels, making it suitable for technical and academic documents.
Will this work with older versions of Typst and Pandoc?
No, it is designed specifically for Typst v0.13 and Pandoc v3.6.4 and later. Compatibility with earlier versions is not guaranteed.
Source: Hacker News
