web·2023·creator
readme.css
A drop-in stylesheet that makes any markdown look like a proper docs site. No build step required.
overview
readme.css is a single ~6KB stylesheet that takes raw markdown HTML and styles it like a real docs site — sensible typography, code blocks that pop, dark mode out of the box, no JavaScript.
It was a reaction to how much friction sat between writing a README and publishing one that looked decent. Now I just link the stylesheet and any HTML rendered from markdown looks like it belongs.
key features
- Drop-in: one <link> tag, zero JS, no build step
- Automatic light + dark themes via prefers-color-scheme
- Hand-tuned typography for prose, code, and tables
- ~6 KB gzipped
- MIT — fork it, theme it, ship it
built with
CSSHTML