Claude Code, HTML, and Markdown — Anthropic's Thariq Shihipar just dropped the thesis breaking the dev internet: markdown is the wrong format for every spec, every plan, every PR writeup you hand your AI coding agent. Here's the 60-second receipts. ▶️ Watch the full video: https://youtu.be/-iSLQe_imrE ---- Want to build your own AI apps but don't know where to start? 🤖👇 Stop struggling alone! Learn how to use Agentic Coding step-by-step with daily live workshops and expert guidance at Dynamous AI. https://dynamous.ai/?code=646a60 Get 10% off here 👉 https://shorturl.smartcode.diy/dynamous_ai_10_percent_discount ---- What you get in 60 seconds: - The "Markdown is dying" thesis from Anthropic's Claude Code team - 750k views, replies split — why this broke the dev internet - 8 things HTML can carry that markdown cannot (tables, CSS, SVG, code, live interactions, workflows, spatial data, real images) - Why agents stop faking ASCII charts the moment you let them write HTML - The "skim vs open" punchline that decides whether your colleague reads the spec - 5 places where switching to HTML changes everything Full breakdown (8-minute long-form): - The 2-4× token cost and why Claude Opus 4.7's 1M context absorbs it - 5 production use cases (specs, code review, design, reports, custom editors) - Why Claude Code specifically beats Claude AI / Claude Design for this - Thariq's real reason for switching: "I stopped reading the markdown plans" Resources: - Full long-form video: https://youtu.be/-iSLQe_imrE - Thariq's HTML gallery (20 examples): https://thariqs.github.io/html-effectiveness/ - Thariq Shihipar (Anthropic, Claude Code team): https://thariq.io - Claude Code docs: https://docs.claude.com/en/docs/claude-code/overview Are you switching your specs, plans, and PR writeups to HTML this week, or sticking with markdown? Drop your take below. #ClaudeCode #HTML #Markdown #Anthropic #ClaudeOpus #ClaudeAI #MCP #AICoding #AICodingAgent #AgenticCoding #VibeCoding #AIWorkflows #AITools #AIAgents #DevTools #SoftwareEngineering #Coding #ArtificialIntelligence #ClaudeCodeTutorial #ThariqShihipar #Shorts
ADVERTISEMENT
Html is for websites which need interaction. Markdown along with mermaid serves quick and standard documentation
Honestly, I think Markdown with HTML segments makes the most sense.
its like everyweek some thing dies, "x is dying, use this instead"
What’s great is that AI is so good you can simply do both! 😊
Markdown has tables and diagrams via mermaid
Well, I prefer the Astro-ish aproach to this: for 99% of work just use the fast, static, and scalable. Only add “islands” whenever you need dynamic content. The best part is that MD already supports HTML and LaTex so you can totally get the best of HTML and other enriched formats while keeping the simplicity of MD where you need it.
Not much I can’t do in MD. I can do tables. I can describe css design but I don’t want to design it always but I can give config blocks. I can do mermaid diagrams, insert images all the things html can do but I hate writing html. I don’t hate writing MD
Yeah sure 5Xing the token usage in an already bleeding hybrid expense model is sure going to work out well lmao
Seams to me that has some valid concerns bot alternative sounds naive, simplistic needs more thougtfull , Considering Advanced Topics like Triegve Rosengaus Data Context Iteration
ow wow, that's a great idea for developers. So, how do i view a HTML plan doc or readme on a headless linux VPS?
html is great and definitely improves the output format, but it's a pain to share. Claude now drafts every document request in html, and then you're kinda stuck with a beautiful design. Very frustrating.
Have we come full circle to bring back dreamweaver and frontpage ?
HTML will always be overkill for notes and textual mediums. For that Markdown is just fine.
Markdown with KaTeX / MathJax / Mermaid and LaTeX snippets can do tables, equations, contents pages, images and figures, appendices. With pandoc it can print to a pdf, convert to a word document, or target any other format. The people inside any company advocating for this are the 0.1x engineers self-reporting, you can safely fire them and lose zero productivity.
Anyone who's built for the web also knows the headaches that do into how markup is handled. MD all day please.
It is hyper text MARKDOWN language anyway
I tell Claude to update my markdown
Anthropic is desperately pushing for us to burn more tokens lol. I mean html for the models is just token bloat. It might also confuse the models which they are not telling us. LLMs operate on text - div, span, etc have no business value so that is no needed for specs, etc.
There’s a anthropic for the anthropic
but does those tags consume more tokens and cause confusion / hallucination in llms. hmmmm