Markdown is having a midlife crisis. Your slide deck should be worried too.

Dispatches from the format wars

Markdown is having a midlife crisis.
Your slide deck should be worried too.

In May 2026, an Anthropic engineer publicly tried to kill Markdown. Days later, the man who taught cars to see agreed with him in public. I’ve built more decks, wikis and Word docs nobody finishes reading than I care to count — so naturally, I had questions.

Here’s what happened, for anyone who missed the drama unfold on their timeline.

Thariq Shihipar, who works on Claude Code at Anthropic, published a piece with a title that reads less like a blog post and more like a diss track: “The Unreasonable Effectiveness of HTML.” His argument, stripped of the niceties: he’d stopped reading his own AI’s Markdown output once it crossed a hundred lines, and he couldn’t get anyone else in his organisation to read it either. Four million views in sixteen hours later, Andrej Karpathy — a man whose day job has involved teaching computers to see — showed up to agree with him. And he brought a diagram.

Karpathy’s case is basically neuroscience with a grudge. Roughly a third of your brain is wired for processing what you see. He calls vision the human brain’s highest-bandwidth channel — a superhighway, in his words, next to which Markdown’s toolkit of bold text, headers and the occasional table looks like a footpath. His progression runs: plain text (effortful), Markdown (today’s default, tolerable), HTML (early, but already forming the better default) — and eventually, several steps out, something he only half-jokingly calls interactive neural video. We are, apparently, one generation of models away from our status reports dreaming at us.

“I tend to not actually read more than a 100-line markdown file” — and, he adds, neither does anyone else on his team. — Thariq Shihipar, Claude Code team, Anthropic

Now — I’ve lived my working life in the Microsoft stack. I have built SharePoint wikis that a project team opened once, at kickoff, and never again. I have shepherded forty-slide decks whose entire purpose was to survive a steering committee meeting before being quietly filed under Final_v3_ACTUALfinal.pptx. If Markdown has a midlife crisis coming, the consulting deck should already be checking its pulse.

Here’s the part that actually matters for those of us in consulting and enterprise knowledge management, because the format war is entertaining, but the implication underneath it is bigger. Markdown, decks and Word docs are cousins of the same idea: knowledge frozen the moment someone hit save, then mailed around as an attachment you need the right tool to even open. HTML breaks that. It’s a link, not an attachment — it opens in the browser everyone already has running. It can hold a real diagram, a colour-coded risk table, or a slider your client actually drags instead of squinting at a frozen number on slide fourteen. And here’s the bit I didn’t expect: the same HTML file a person reads is the file an AI agent reads back later, as its own working memory of the decision. It stops being a report. It becomes a surface both of you keep working from.

There’s a second reason this isn’t only a human-readability story, and it’s the one that should worry knowledge management teams more than the first. AI doesn’t just write HTML well — it reads HTML back better than almost anything else you hand it. A PDF is, structurally, a page of positioned ink; extracting a table means an agent reverse-engineering the fact that fifty scattered text fragments happen to line up in columns. A PowerPoint slide is XML underneath, but it’s a bag of shapes sitting at x/y coordinates with no defined reading order — nothing tells an agent that this box is the heading and that one’s a footnote somebody forgot to delete. Markdown is flatter still: headings, bullets, bold, and not much else to express a relationship like “this row is the high-severity one.” HTML is the outlier, because it was never built to look pretty first — it was built to be a tree. Every tag nests inside another, every table row is genuinely tied to a header, and screen readers have been parsing exactly that structure for people with visual impairments since long before anyone trained a language model on anything. AI agents didn’t invent a new way to read documents. They just showed up to a format that had already solved the problem.

.pdfflattened ink — table structure has to be guessed from pixel positions
.pptxshapes at x/y coordinates — no defined reading order
.mdheadings and bullets — no way to express relationships between them
.htmla nested, tagged, queryable tree — the format screen readers have relied on for decades

→ don’t take my word for it

Below is the single most-produced artefact in enterprise consulting: the solution architecture diagram. Same system, four formats — in the order history gave them to us. Watch what happens to the diagram as you move right. Then, on the last tab, click the components. Try doing that to slide 14.

Customer Service AI Agent – Solution Architecture Overview. Customer queries arrive through three channels, namely web chat embedded on the customer portal, Microsoft Teams for internal service desk scenarios, and voice via the omnichannel telephony integration. All channels route into the Copilot Studio agent which acts as the orchestration layer, handling topic recognition, generative answers and action execution. For generative responses the agent calls the Azure OpenAI deployment which must remain in the UK South region for data residency reasons. Knowledge grounding is provided by a curated SharePoint site containing service documentation, and it should be noted that the quality of generative answers is directly dependent on the currency of this content. Where a query cannot be resolved the agent creates or escalates a case in Dynamics 365 Customer Service via Dataverse, using a service principal which should be configured with least privilege access. The reader is asked to hold all of the above in their head simultaneously in order to understand how a single customer query flows through the system, as no diagram is available in this format.

Customer Service AI Agent — Architecture

architecture.md · last commit: “fix diagram alignment (again)”
+------------+       +-----------------+      +----------------+
|  Channels  | ----> |  Copilot Studio | ---> |  Azure OpenAI  |
|  (web chat,|       |      Agent      |      |  (UK South)    |
|  Teams,    |       |                 |      +----------------+
|   voice)   |       |                 | ---> | SharePoint KB   |
+------------+       |                 |      +----------------+
                     |                 | --> | Dataverse / D365 |
                     +-----------------+      +---------------+
  • Azure OpenAI must stay in UK South (data residency)
  • SharePoint KB currency drives answer quality
  • D365 service principal: least privilege

Note: boxes may not align depending on your editor’s font. The third arrow is not load-bearing.

Customer Service AI Agent — live diagram

Channels web · Teams · voice Copilot Studio agent · orchestration Azure OpenAI UK South SharePoint KB knowledge grounding Dataverse / D365 case escalation
Click any component
Every box above is clickable. The paragraph in architecture.txt asked you to hold this whole system in your head — here, the diagram holds it for you.
↳ same file a colleague opens in a browser — and an AI agent parses as a tree. no Visio licence required.
CLIENT CONFIDENTIAL — DO NOT DISTRIBUTE

Solution Architecture – Customer Service AI Agent

Channels
Copilot Studio Agent
Azure / D365
(various)
  • High-level view only — detailed architecture maintained in Visio
  • Data residency, knowledge grounding & security covered in Appendix, slide 38
Speaker notes — last opened: never
The Visio link has been broken since the file-server migration. If anyone asks, the diagram is “directionally correct.”
↳ 412 of these currently live in your organisation’s SharePoint.

To be fair to Markdown’s defenders — and there are furious ones — HTML isn’t free. It costs more tokens to generate, it’s messier in version control, and giving an AI agent free rein to write JavaScript into your organisation’s knowledge base is the kind of decision that ages badly if nobody’s reviewing it. This isn’t “burn every deck you own by Friday.” It’s “stop assuming static and unreadable is the safe, neutral choice.” It never was — we just didn’t have an alternative that an AI could produce for the price of asking.

Earlier in my career I’d have called this a UX problem. Turns out it always was one. We just needed the AI to write the interface for us, so we’d stop pretending bullet points were a design system.

If your organisation’s knowledge base is a graveyard of unread PDFs and decks with three different “final” versions — that’s not a content problem. It’s a format problem, and for the first time, the format is cheap to fix.

Written by someone who has built more SharePoint sites than he’d like to admit, now building AI-native knowledge tooling instead.
Sources: Andrej Karpathy on X · Thariq Shihipar, “The Unreasonable Effectiveness of HTML”

Leave a Reply

Discover more from Bharath Devulapalli

Subscribe now to keep reading and get access to the full archive.

Continue reading