Because I like to share knowledge
After my talk “Arc42: The Art of Simple Software Architecture Documentation” at Bitbash 2026, a surprising number of people reached out.
Not just with nice talk
, but with can you share the slides?
.
People told me they saw the deck as a reference guide.
That was the trigger to write it down properly.
When the same question comes back again and again, it usually means the same thing: arc42 is widely known, but it is hard to find practical guidance and shareable examples.
Generating a nicely formatted PDF is surprisingly hard with traditional .NET libraries. Pixel‑perfect layout often requires low‑level drawing APIs or proprietary tooling.
When looking for a solution, I stumbled upon Microsoft Playwright, a library for end-to-end testing in the browser.
This in itself might not sound like a good fit for PDF generation, but if you know that the print preview inside a Chromium browser is actually a rendered PDF, it makes more sense.
So if we can render HTML in a browser, we can also export it to PDF. And this gives us all the flexibility of HTML and CSS for layout, without the hassle of low-level drawing APIs.
This post is a continuation of my migration journey from WordPress to Astro. If you have not read the previous posts, you might want to start with Why I Switched from WordPress to Astro, How I Moved My Blog Content and how I am Replacing WordPress Plugins with Astro: Acronyms, Meta Tags & Tag Clouds.
In this post, I cover how I replaced the next set of WordPress plugins with equivalent functionality in Astro:
This post is a continuation of my migration journey from WordPress to Astro. If you have not read the previous posts, you might want to start with:
In this post, I explain how I replaced 3 WordPress plugin functionalities in Astro.
After 15 years of blogging with WordPress, I decided to take the plunge and migrate my blog to Astro.
This post outlines how I moved my content, step by step, and the tools I used to make the transition.
This is a follow-up to my previous post: Why I Switched from WordPress to Astro: Faster, Cheaper, and Greener.