TL;DR
In 2025, a developer released an updated Typst template for Pandoc to improve markdown to PDF conversion. The new template separates Pandoc and Typst logic, enhancing robustness and customization. This development responds to recent software updates and aims to streamline academic and professional document formatting.
A new Typst template for Pandoc has been released in 2025, designed to improve the process of converting markdown documents into PDFs with enhanced layout and typography. The update addresses compatibility issues caused by recent upgrades to Typst (to v0.13) and Pandoc (to v3.6.4), which rendered previous templates obsolete. This new template separates Pandoc’s template logic from Typst’s, making the workflow more robust and easier to customize, according to the developer behind it.
The developer, active on Hacker News, explained that the new template leverages Pandoc’s default Typst output template, which now does minimal formatting, instead relying on a dedicated Typst template that is invoked via a variable passed during the Pandoc command line. This approach improves clarity and long-term stability, as it isolates Pandoc’s logic from Typst’s formatting code.
The template, downloadable from the developer’s site, processes document metadata such as title, author, and date, and offers customizable options for headers, footers, fonts, and section styles. It supports advanced formatting features like ligatures, old-style figures, and styled headings, as well as specific styling for block quotes, images, footnotes, and labeled sections like references and epigraphs. The template also includes regex-based text styling, such as small caps for dates and URL formatting.
Instructions specify that the template should be used with a command like: pandoc file.md -o file.pdf -V template=article.typ --pdf-engine=typst. The setup assumes a markdown file with a metadata block for document info. The developer notes that users can disable or modify sections of the template for their needs, making it flexible for various types of documents.
Why It Matters
This development matters because it enhances the stability and flexibility of markdown-to-PDF workflows, especially for academic, technical, and professional documents. By separating Pandoc’s logic from Typst formatting, the template reduces compatibility issues caused by software updates, ensuring users can maintain consistent document styles over time. It also provides a foundation for further customization, making high-quality typesetting more accessible for non-expert users.
Markdown to PDF converter software
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background
Last summer, the developer created an initial Typst template for Pandoc v0.11, aiming to streamline document formatting. Since then, both Typst and Pandoc have undergone major updates—Typst to v0.13 and Pandoc to v3.6.4—necessitating a rebuild of the workflow. The new template reflects these changes, emphasizing a modular approach that separates Pandoc’s template variables from Typst’s styling code. This aligns with ongoing efforts in the open-source community to improve document processing pipelines amid rapid software evolution.
“This new template leverages Pandoc’s default Typst output template, which now does minimal formatting, relying instead on a dedicated Typst template invoked via a variable.”
— Developer on Hacker News
“The setup assumes a markdown file with a metadata block for document info, and the template can be customized for various document styles.”
— Developer on Hacker News
As an affiliate, we earn on qualifying purchases.
What Remains Unclear
It is not yet clear how widely adopted this template will become or how it will perform with complex or highly customized documents. Compatibility with future versions of Typst or Pandoc remains to be tested, and user feedback on usability and stability is still emerging.
PDF editing software for academic documents
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What’s Next
Next steps include wider testing by the community, potential integration into standard Pandoc workflows, and further customization options based on user feedback. The developer may also release updates to improve features or address issues as they arise.
professional document formatting tools
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
How does this new template improve over previous versions?
The new template separates Pandoc’s logic from Typst’s formatting, making it more robust against software updates and easier to customize for specific document styles.
Can I customize the styles in the template?
Yes, the template is designed to be customizable, allowing users to modify headers, fonts, section styles, and other formatting options through Typst code.
Is this template compatible with all versions of Pandoc and Typst?
It is compatible with Pandoc v3.6.4 and Typst v0.13, based on current testing. Future compatibility depends on ongoing updates from the developers.
Where can I download the template?
The developer provided a download link on Hacker News, with instructions included in the post.
Source: Hacker News
