An Anthropic engineer argues that while Markdown is the current standard for AI agent communication due to its simplicity and portability, HTML offers significantly better capabilities for rich visualizations, color, diagrams, and interactive elements. The discussion highlights that Markdown was originally designed as a syntax meant to be converted into HTML rather than serving as the final output format itself.
Key points:
- Limitations of Markdown regarding visual complexity and richness.
- Advantages of HTML including CSS styling and JavaScript interactivity for AI outputs.
- Historical context of Markdown's purpose as an intermediary tool for generating HTML.
Key points:
- Limitations of Markdown regarding visual complexity and richness.
- Advantages of HTML including CSS styling and JavaScript interactivity for AI outputs.
- Historical context of Markdown's purpose as an intermediary tool for generating HTML.
Simon Willison discusses why requesting HTML rather than Markdown as an LLM output format can significantly enhance technical explanations. While token constraints previously favored Markdown, modern models benefit from the ability of HTML to incorporate SVG diagrams, interactive widgets, and improved navigation. The article provides prompt examples for reviewing pull requests via HTML artifacts and showcases a GPT-5.5 generated explanation of a Linux security exploit that uses CSS and JavaScript to create a rich documentation experience.
Cloudflare converts HTML to Markdown on the fly when an AI agent requests it via the `Accept: text/markdown` header.
Cloudflare launched Markdown for Agents, converting HTML pages to markdown automatically when AI crawlers request it through content negotiation. This feature is available in beta at no additional cost for eligible paid plans.
The way content is discovered online is shifting, from traditional search engines to AI agents that need structured data from a Web built for humans. It’s time to consider not just human visitors, but start to treat agents as first-class citizens. Markdown for Agents automatically converts any HTML page requested from our network to markdown.
MinerU is a tool that converts PDFs into machine-readable formats (e.g., markdown, JSON), allowing for easy extraction into any format.
Render any git repo into a single static HTML page for humans or LLMs. Flatten any GitHub repository into a single, searchable HTML page with syntax highlighting, markdown rendering, and a clean sidebar navigation.
ReaderLM-v2 is a 1.5B parameter language model developed by Jina AI, designed for converting raw HTML into clean markdown and JSON with high accuracy and improved handling of longer contexts. It supports multilingual text in 29 languages and offers advanced features such as direct HTML-to-JSON extraction. The model improves upon its predecessor by addressing issues like repetition in long sequences and enhancing markdown syntax generation.
ReaderLM-v2 is a 1.5B parameter language model designed to convert raw HTML into beautifully formatted markdown or JSON. It supports multilingual input and offers improved longer context handling, stability, and advanced markdown generation capabilities.
MarkItDown is a utility for converting various files to Markdown, including PDF, PowerPoint, Word, Excel, Images, Audio, HTML, text-based formats, and ZIP files.
