Markdown for AI Agents

Markdown for AI Agents is a lightweight WordPress plugin that enables HTTP content negotiation for your site’s content. When a client (like an AI agent or a custom script) requests a page with the Accept: text/markdown header, the plugin intercepts the request and returns a clean, structured Markdown representation of the post or page content.

This is ideal for AI crawlers, RAG (Retrieval-Augmented Generation) systems, and non-browser clients that prefer machine-friendly text over complex HTML.

Important note: This plugin is primarily a developer/integration tool. Human visitors browsing your site will never see any difference — the Markdown output is only served when explicitly requested via the Accept: text/markdown HTTP header. Normal browser requests always receive the standard HTML page.

Key Features:

Automatically detects Accept: text/markdown headers.

Converts HTML content to clean Markdown using the League HTMLToMarkdown library.

Strips away theme layout, navigation, headers, footers, and sidebars — serving only the main content.

Adds useful HTTP response headers: Content-Type: text/markdown, Vary: Accept, and X-Markdown-Word-Count.

Respects WordPress visibility rules and filters.

No configuration required — works out of the box for posts, pages, and custom post types.

How It Works This plugin uses a standard web technique called HTTP content negotiation. The same URL on your site can serve different representations of the same content depending on what the client asks for:

A regular browser sends Accept: text/html → receives your normal HTML page.