Neither HTML nor Markdown is enough

Show HN: Neither HTML nor Markdown is enough: a way out of the AI doc dilemma

Operating in show hn launch, Neither HTML nor Markdown is enough operates.

Profile

A recent post from Anthropic's Claude Code team ("The Unreasonable Effectiveness of HTML", https://thariqs.github.io/html-effectiveness/) argued that with today's context windows the bottleneck is human attention — rich HTML for decision surfaces, Markdown for durable records. That split makes sense to me. What it leaves open, in my experience, is the durable record itself: what happens when that is the thing an agent must iteratively co-author? You end up picking one and paying for the other — a surface people will read, or a record you can keep — and whichever you pick, the other drifts.Markdown treats the document as one long flat string — an agent has to quote context back just to say wh

Its activity falls under show hn launch; the profile below is assembled from public directory data.

Its current recorded stage is Show HN launch.

Website: thariqs.github.io/html-effectiveness