Google’s John Mueller Says Don’t Build Separate Markdown Pages for AI Search
Reorder anchor tags in code to place the desired link first instead of converting a button to a non‑link.
Move the desired link earlier in the HTML and use CSS to position it, keeping it as an <a> tag.
Summary
Google’s John Mueller cautioned against building separate markdown or llms.txt pages for AI agents, arguing that a well‑designed HTML site already serves both humans and machines.
The discussion stemmed from a Bluesky post about providing a text version for LLMs while neglecting accessibility best practices. Mueller emphasized that adding a second, machine‑only version creates technical debt and requires future redevelopment. He suggested that agencies focus on fixing existing HTML markup rather than duplicating content for AI consumption. The guidance aligns with earlier warnings from Mueller and Martin Splitt about the pitfalls of parallel markdown versions. The recommendation is to prioritize proper heading structure, landmarks, and accessible markup to satisfy both users and search engines. For sites that currently maintain a markdown mirror, the advice is to consolidate content into a single, well‑structured page.
Key changes
- Mueller cautions against building separate markdown or llms.txt pages for AI agents.
- Separate machine‑only versions create technical debt and require future redevelopment.
- A well‑designed HTML site already serves humans and machines.
- Emphasizes fixing existing HTML markup over duplicating content.
- Aligns with earlier warnings from Mueller and Martin Splitt.
- Recommends proper heading structure, landmarks, and accessible markup.
- Suggests consolidating content into a single, well‑structured page.