Serkan Algur

Markdown Content Negotiator for LLMs is a performance-optimized WordPress plugin designed to serve your website’s content in a format that AI agents and LLMs (Large Language Models) love: Clean Markdown.
Using standard HTTP Content Negotiation, the plugin detects when a request is made with the <code>Accept: text/markdown</code> header. Instead of serving the standard HTML theme, it returns a Markdown version of the post or page, complete with YAML Frontmatter, token estimation headers, and customizable content signals.
To ensure maximum performance and minimal server load, Markdown versions are pre-generated and cached using WP-Cron.
<h4>Key Features</h4>
<ul>
<li>Content Negotiation: Automatically switches to Markdown output when requested via the <code>Accept: text/markdown</code> header.</li>
<li>YAML Frontmatter: Includes metadata like Title, Date, Author, and Categories in a structured format.</li>
<li>Performance Tracking: Provides an <code>X-Markdown-Tokens</code> header using standard LLM token heuristics.</li>
<li>AI Metadata: Includes <code>X-Content-Signal</code> headers to help agents understand the nature of the document.</li>
<li>Background Caching: Uses WP-Cron to pre-calculate Markdown strings, ensuring zero latency during requests.</li>
<li>Admin Settings: Choose which post types to enable and configure global AI content signals.</li>
</ul>

Markdown Content Negotiator for LLMs

Detects Accept: text/markdown and serves pre-generated Markdown versions of posts and pages for AI agents and LLMs.

Umay Ajans

Modern AI agents (ChatGPT, Claude, Perplexity, Gemini, etc.) work much better with Markdown than HTML. Umay AI Markdown inspects the incoming <code>Accept</code> header and, only when <code>text/markdown</code> is requested, intercepts the response and serves a clean, agent-friendly Markdown representation of the page.
Browsers, search engines, and any client that does not explicitly ask for Markdown receive the unchanged HTML response. There is no settings page, no cron job, and no external service call.
Key features
<ul>
<li>Zero configuration — install, activate, done.</li>
<li>Only triggers when <code>Accept: text/markdown</code> is present. Regular visitors and search engines are never affected.</li>
<li>Hybrid content extraction: uses <code>the_content</code> for posts/pages, falls back to a DOM-based extractor for archives, taxonomies, and the homepage.</li>
<li>Powered by the industry-standard <a href="https://github.com/thephpleague/html-to-markdown" rel="nofollow ugc">league/html-to-markdown</a> library.</li>
<li>Transient-cached for 12 hours per URL (sha256-keyed). Auto-invalidated on <code>save_post</code>, term edits, theme switches, and menu updates.</li>
<li>Built-in IP rate limiter (30 requests / minute by default) to mitigate abuse.</li>
<li>Strict input sanitization, header injection protection, libxml entity hardening (XXE-safe), and full WordPress Coding Standards compliance.</li>
<li>PSR-4 autoloaded, namespaced OOP code. No globals.</li>
<li>Sends <code>Vary: Accept</code>, <code>X-Robots-Tag: noindex</code>, and <code>X-Content-Type-Options: nosniff</code> on every Markdown response.</li>
</ul>
What gets sent to AI agents
Each Markdown response includes a YAML front-matter block with the page title, site name, canonical URL, and ISO-8601 generation timestamp, followed by the page body converted to Markdown. Navigation, footer, sidebars, scripts, styles, comment forms, related posts, and other page chrome are stripped before conversion.
Filters
Two filters are available for advanced customization:
<ul>
<li><code>umay_mdn_bypass</code> — Return <code>true</code> to skip Markdown handling for the current request.</li>
<li><code>umay_mdn_cache_ttl</code> — Override the default 12-hour cache lifetime (in seconds, minimum 60).</li>
<li><code>umay_mdn_rate_limit</code> — Override the default 30-requests-per-minute rate limit.</li>
<li><code>umay_mdn_converter_options</code> — Modify the league/html-to-markdown converter options array.</li>
</ul>

Umay AI Markdown

Serves clean Markdown to AI agents (ChatGPT, Claude, Perplexity) on Accept: text/markdown. HTML stays default for browsers. Zero-config.

Markdown Content Negotiator for LLMs vs Umay AI Markdown