Blog

Writing on diagrams

Practical notes on diagram tooling, README design, and developer ergonomics. Cross-posted on Dev.to.

All Tutorial Opinion Comparison Workflow Listicle Story

Why Your GitHub README Diagrams Look Amateur (and the 4 Fixes That Take 10 Minutes)

Most README diagrams suffer from the same four defaults. Here's how to fix all of them in under ten minutes — without redrawing anything.

May 19, 20261 min read

TutorialMay 12, 2026

How to Render Mermaid Diagrams as SVG (and Stop Looking Like Every Other README)

A practical guide to rendering Mermaid as SVG — from the official CLI to custom themes, font fixes, dark mode, and when to stop fighting the defaults.

Read article →