May 27, 2026

PDF Wars: Template Strikes Back

A New Typst Template for Pandoc

Cool new PDF recipe drops, but the comments are split between “thanks!” and “what is this?”

TLDR: A new template promises prettier PDFs from plain text by separating the layout logic into a more durable setup. But the comments stole the spotlight, with readers split between grateful excitement, total confusion, and the now-traditional fear that the software has already changed again.

A writer proudly unveiled a rebuilt way to turn simple text files into polished PDFs using Pandoc and Typst, after older templates broke when both tools kept updating. In plain English: they made a new reusable layout system so articles and papers can look nicer on the page, with cleaner headings, quotes, images, footnotes, and even fancy left-right book-style page headers. Very neat, very practical — and instantly upstaged by the comments section, which became the real show.

One camp was grateful and ready to print. One reader basically shouted, finally, someone posted this, saying they’d just started using Pandoc to format books for a secondhand Sony reading device. That’s the wholesome side of the internet. But the louder energy came from the confused and skeptical crowd. One commenter flat-out admitted they had no idea what the article was talking about, which is honestly the most relatable review possible. Another wanted receipts: where’s the sample markdown, where’s the finished PDF, and why should anyone care without a before-and-after reveal?

Then came the classic open-source plot twist: version drama. A commenter pointed out that the template was already written in March 2025, and now it’s May 2026 — meaning the software has moved on again. Oof. So the vibe was equal parts admiration, confusion, and that very online feeling of watching someone fix a moving target while the crowd yells, “Looks useful! Also… is it already outdated?”

Key Points

  • The author rebuilt a Markdown-to-PDF workflow after Typst and Pandoc version changes caused earlier templates to stop working.
  • The new workflow uses Pandoc’s default Typst output template together with a separate Typst-native template passed through `-V template=article.typ`.
  • The article explains that Pandoc’s `template.typst` watches for the template variable and imports the named Typst template.
  • The rebuilt template is designed to collect standard metadata from Markdown source files, including fields such as title, author, and date.
  • The template includes configurable layout and typography features such as running headers and footers, OpenType font settings, styled block elements, and multiple heading definitions.

Hottest takes

"I have no idea whether I'm interested or not from this article" — llimllib
"I've just started my Pandoc journey" — adolph
"my templates don’t work anymore" — Terretta
Made with <3 by @siedrix and @shesho from CDMX. Powered by Forge&Hive.