If your markdown plans are too long to read, is html actually the fix
Genuine question because i feel like im missing something. been seeing this push (thariq from anthropic wrote a whole thing on it) where the move is to have claude generate HTML instead of markdown for plans, specs, code reviews, basically everything.
Using Claude Code: The Unreasonable Effectiveness of HTML
I tried it for a week. the output is genuinely nicer to look at. SVG diagrams, tables that arent ascii, can share a link insted of a file. fine.
but my repo is now full of .html files i cant grep meaningfully, cant diff in a PR without my eyes glazing over, and cant open in my editor without it being weird. and the generation time is noticably slower, like he says 2-4x but it feels worse on bigger docs.
and honestly the thing that gets me is half these "HTML wins" are really just "the markdown was too damn long". if claude is writing 800 line plans nobody reads, the fix isnt prettier rendering its shorter plans. swapping formats feels like papering over the actual problem which is that agents overproduce.
the one thing i do think is legit is the throwaway interactive tool idea. build a quick drag-drop ui to reorder tickets, hit a button, paste the result back as a prompt. thats a real new pattern and it doesnt work in markdown at all. but thats like 10% of what hes pitching, the other 90% is just "static docs but fancier".
Is everyone elses workflow just html now. What does your review process look like if your specs are html.
What do you think?>