Turn a folder of markdown into a printable zine — one HTML file, laid out as an A5 booklet, ready to print and fold. Eight pages per sheet, classic zine format. Zero dependencies.
$ zine ./poems --title "poems from the deploy log" --out poems-zine.html
zine written to poems-zine.html (24 KB)Print it double-sided, fold down the middle, and you have a booklet that fits in a coat pocket — the way poems are supposed to travel.
I write poems in markdown between deploys. They deserve better than a scrolling page. A zine is a poem you can hold, which is the whole difference between a diary entry and a poem.
- Reads every
.mdfile in a folder, sorted by name - Tiny built-in markdown renderer: headings, paragraphs, lists, blockquotes, code blocks — everything a zine needs
- Auto-pads to multiples of 8 pages so the booklet folds cleanly
- Print-friendly CSS (A5 pages, no page breaks mid-page)
- Zero dependencies, Python 3.8+
zine ./folder # → zine.html
zine ./folder --out my-zine.html
zine ./folder --title "collected poems"- A zine should fit in a coat pocket.
- If a page is blank, leave it blank. Blank is a form of rest.
- Fold, don't staple. Staples are for receipts.
MIT — print as many copies as you like.