Split illustration comparing dense HTML markup on the left with clean, minimal Markdown syntax on the right, representing the Markdown versus HTML debate for SEO and AI crawlers.

Should You Turn Your Site Into Markdown for AI? Google Just Weighed In.

Technical SEO • AI Search • June 2026

Should You Turn Your Site Into Markdown for AI? Google Just Weighed In.

Someone asks Martin Splitt this question often enough that he brought it to his own boss on a podcast. The answer took the two of them twenty-five minutes to fully unpack, and it is more useful than the one-line summary going around.

Hazem Khattab June 17, 2026 7 min read Technical SEO • AI Crawlers • Content Strategy
The line that ended the debate
"For all of the SEO-related things and discovery of content, a normal HTML website is like... the best."
John Mueller, closing out Search Off the Record episode 111, after twenty-five minutes of genuinely going back and forth on it with Martin Splitt.

Martin Splitt opened a recent episode of Google's Search Off the Record podcast with a question he says he gets asked constantly: should a website be converted into Markdown so that large language models have an easier time reading it? He came in with an opinion already formed. By the end of the conversation with John Mueller, that opinion had survived, but it picked up a lot of nuance along the way that the headline coverage mostly skipped.[1]

The short version that spread across SEO news sites this week is accurate but flattened: Google says HTML is the standard, Markdown gives you nothing for SEO.[2] That is true. It is also not the most useful part of what was actually said. The interesting part is why, and where the exceptions genuinely sit.


The Argument Before the Argument

Splitt's opening case for Markdown was reasonable on its face. Markdown gives you headings, lists, tables, links, and images using a fraction of the syntax HTML requires. It is harder to get wrong, faster to write, and the structure is readable even with no rendering at all. None of that is in dispute.

His counterargument to his own idea is what made the episode worth listening to. Every crawler that exists today already had to solve the problem of reading HTML at the scale of the entire web. Asking the ecosystem to suddenly prioritise a parallel Markdown version is solving a problem that does not exist, because the harder problem was already solved years ago.

MS
Martin Splitt
All the crawlers that exist today had to deal with HTML for the breadth of ingesting the web. You can't just say we're only going to get the Markdown files. So I don't think that's a problem that needs solving.
JM
John Mueller
So you know the best practices for making good websites, right? How do you write the content for your site? Do you write HTML or Markdown?

That second line from Mueller is doing more work than it looks like. Splitt, it turns out, writes his own personal site entirely in Markdown through a static site generator he built himself, specifically because he does not want to type angle brackets. Mueller used that admission to pivot the whole conversation: if the advice is "don't bother with Markdown," but the person giving the advice writes in Markdown daily, the real answer needs more precision than a flat no.


What Markdown Actually Is, and Why It Exists

Mueller looked into the history for the episode. Markdown was created in 2004 by John Gruber and Aaron Swartz, with the goal of producing something close to plain, readable English that converts cleanly into HTML and back again.[1] It assumes HTML already exists. It is not a competitor to HTML. It is a more pleasant way to author the same eventual output.

Splitt's framing of this point is the most useful technical summary in the whole episode: Markdown gives you semantic structure almost by accident. A heading is unmistakably a heading. A link is unmistakably a link. There is very little room to accidentally make something look like a heading without it actually being one, which is a mistake that happens constantly in hand-coded or poorly templated HTML.

The Catch Mueller Raised
That clean separation only holds if you do not cheat. Most Markdown processors let you drop raw HTML straight into the file when you need something Markdown cannot express, embedding a video, adding a JavaScript widget. The moment you do that, you have re-imported all the complexity Markdown was supposed to remove. Used honestly, Markdown forces a clean split between content and presentation. Used as an escape hatch, it becomes HTML with extra steps.

Why "Less Text" Does Not Mean "Better for AI"

The instinct behind wanting a Markdown version for AI systems is straightforward: open a raw HTML file in a text editor with no browser rendering it, and it is genuinely hard to read. Tags everywhere, inline styles, navigation markup tangled in with the actual content. Open a Markdown file the same way and it is still legible. A link still reads as link text in square brackets followed by a URL in parentheses.

Splitt's point is that this readability difference is real but irrelevant, because no crawler is reading raw HTML the way a human squints at a text file. Converting HTML into plain text is a solved, trivial problem with mature tooling on every side of the industry. The supposed advantage of Markdown, being easier to extract text from, stopped mattering once HTML-to-text extraction became a commodity.

The web crawlers were never the bottleneck. They solved HTML parsing a long time ago. Building a parallel Markdown version solves a problem nobody downstream actually has.

There is a second, quieter cost that the conversation kept circling back to. Markdown by design strips out everything around the content: headers, footers, sidebars, the navigation that tells a crawler how a page connects to the rest of a site. Mueller pointed out that for a search engine specifically, those structural links are not noise to be removed. They are how Discovery works. A clean Markdown excerpt of an article with the surrounding site architecture stripped away is, from a crawling standpoint, a worse signal than the messy HTML it came from.


The llms.txt Question, Settled Pretty Bluntly

Splitt asked the natural follow-up: if not a full Markdown site, what about an llms.txt file, a plain text summary file aimed specifically at language models? Mueller had spoken directly with one of the people behind the original llms.txt proposal, and his read on its intended purpose was clear.

The file was never designed as a discovery mechanism, a way to get found by AI systems that have not encountered the site yet. It was designed for a narrower case: an AI agent that already knows about a site and a user, and wants a structured way to look around once it is already there. Mueller's framing of why the discovery use case fails is the sharpest line in the episode.

JM
John Mueller
You're basically telling these systems, I have the best website ever, and here are all the pages everyone must go to, and you must buy all of my products. An LLM system, by design, can't trust that as a way of differentiating between websites.

That is the core problem with treating any self-authored file as an AI optimisation lever. A file you control, describing how great your own site is, is not a credibility signal to a system trying to figure out which site is actually the best answer to a query. It is closer to a sales pitch the system has every reason to discount.

Editorial illustration of an llms.txt file being inspected by an AI agent icon, representing the limited and narrow role of self-authored AI text files in search discovery

Where the Exception Genuinely Lives

Neither of them dismissed Markdown outright, and this is the part most of the secondary coverage compressed into a footnote. Developer documentation is the one category where both agreed a Markdown version earns its keep, because the audience reading it is frequently a developer or a coding agent that already works in Markdown natively and benefits from getting the raw syntax directly.

Markdown earns its place
API references, developer documentation, code-sample-heavy technical content where the reader or the agent consuming it is already working in a Markdown-native environment, and where a human-facing HTML version is generated from the same source rather than maintained as a separate file.
Markdown adds nothing
Product pages, service pages, blog content, anything aimed at a general audience or general discovery through search. Maintaining a parallel Markdown version here means double the upkeep, a version users never see, and content that can silently break with nobody noticing.

Mueller's closing line on this was blunt enough to quote directly: if you are selling shoes, you are not going to have a Markdown version of your shoe catalogue. He attributed the temptation to a developer bias, the assumption that because developers personally find Markdown easier, every type of website must benefit from the same approach. Most websites are not run by developers alone, and most content is not documentation.


The Parallel-Versions Problem Nobody Budgets For

The strongest practical warning in the episode had nothing to do with crawlers and everything to do with maintenance. The moment a site runs two versions of its content, a public HTML version and a separate Markdown or JSON version aimed at automated systems, it has taken on a maintenance burden that compounds quietly.

  • 1 If the human-facing page breaks, a user notices and tells you. If the automated-only version breaks, nobody does, and a crawler may keep indexing stale or broken content indefinitely without any signal reaching you.
  • 2 Every content update now needs to happen in two places, or through a pipeline that keeps them in sync. That pipeline is itself a new point of failure that did not exist when there was only one version of the truth.
  • 3 Both Splitt and Mueller drew a direct comparison to dynamic rendering, an earlier-generation workaround where sites served a different version of a page to crawlers than to users. It worked as a stopgap, then became a maintenance and debugging burden once sites depended on it long term. A parallel Markdown layer risks the same trajectory.
  • 4 The cleanest answer to wanting both formats is generating one from the other through a single pipeline rather than maintaining two sources by hand, the same approach Splitt already uses for his own site with its static-site-generator setup.

What This Means If You Run a Website

If someone on your team has asked whether converting the site to Markdown, or standing up an llms.txt file, would help with AI visibility or search performance, the answer from the people who build Google's crawling and indexing systems is consistent and specific. Clean, well-structured HTML with proper headings, working internal links, and clear semantic markup remains the entire foundation. Nothing about the rise of AI search systems changes that foundation, because those systems are still built on the same HTML-parsing infrastructure search engines have used for decades.

Where the conversation actually has room to add value is for sites with substantial developer-facing content, where a genuine Markdown layer generated from the same source as the HTML can serve coding agents and human developers without creating a second source of truth. For everyone else, including most commercial sites doing generative engine optimisation work, the energy is better spent on the boring fundamentals: structured data, clean semantic HTML, and a site architecture a crawler can actually navigate.

The Honest Summary
Markdown is a genuinely good authoring format. It is not an SEO format, and it never claimed to be one. The confusion comes from conflating "easier for a human to write" with "more discoverable by a machine," and those are unrelated properties. If your content workflow is easier in Markdown, keep using it, and generate clean HTML from it as the single source of truth. If someone tells you to publish a parallel Markdown version of your product pages to help with AI search, that advice does not hold up against what the people building these systems actually said.

References
  1. Splitt, Martin and Mueller, John. "Search Off the Record, Episode 111: Markdown vs. HTML." Google Search Central podcast, June 2026.
  2. Schwartz, Barry. "Google Says HTML The Standard For SEO, Not Markdown Files." Search Engine Roundtable, June 2026. seroundtable.com
Not sure if your site's technical structure is actually crawler-friendly?
Format debates aside, the fundamentals of clean HTML and site architecture are still what carries the weight. Let's check yours.
Get in Touch →