chancerylaneproject

Markdown for Agents and Statistics converts your WordPress content to Markdown and serves it 
to AI agents and language model tools that request it via HTTP content negotiation 
(<code>Accept: text/markdown</code>).
The Chancery Lane Project is a charity that helps organisations reduce emissions using the power of legal documents and processes. We’ve published this plugin as we believe that making content more legible for AI Agents makes a meaningful difference to their energy usage – not only by reducing the amount of tokens required (by up to 90% over HTML) to consume the content, but also minimising the server resources required to render, process and display pages at source.
How it works:
<ol>
<li>Posts and taxonomy archive pages are converted to Markdown and saved as static 
files on disk inside <code>wp-content/uploads/</code>.</li>
<li>When a visitor (or AI agent) requests a page with <code>Accept: text/markdown</code> in 
the HTTP headers, WordPress serves the pre-generated <code>.md</code> file directly — 
no page render required.</li>
<li>A <code><link rel="alternate" type="text/markdown"></code> tag is added to each page’s 
 so agents can discover Markdown versions automatically.</li>
</ol>
Features:
<ul>
<li>Content negotiation (<code>Accept: text/markdown</code>, <code>?output_format=md</code>, or known AI User-Agents)</li>
<li>Taxonomy archive support — category, tag, and custom taxonomy term pages served as Markdown post listings</li>
<li>Automatic Markdown generation on post save; taxonomy archives auto-update when any post in the term changes</li>
<li>AJAX bulk generation with live progress counter — no page timeouts on large sites</li>
<li>Per-post-type field configuration — choose which meta/ACF fields go in frontmatter or body</li>
<li>ACF support with dot notation for nested group fields (e.g. <code>group.subfield</code>)</li>
<li>Content fields option — use ACF fields as the body content instead of post_content</li>
<li>Manifest generation with content hashes and change tracking per post type</li>
<li>Incremental export — only re-export changed documents (<code>--incremental</code>)</li>
<li>Delta file (<code>changes.json</code>) for RAG system sync</li>
<li>Access statistics — logs AI agent requests with a dedicated stats admin page</li>
<li>Optional frontmatter fields — hierarchy (parent/ancestors/children IDs), author display name, root-relative featured image paths</li>
<li>Topics section — appends a <code>## Topics</code> section with linked taxonomy terms to the Markdown body</li>
<li>Export preview — preview generated Markdown inline in the post editor without writing to disk</li>
<li>WP-CLI commands: <code>generate</code>, <code>generate-taxonomies</code>, <code>prune-stats</code>, <code>status</code>, <code>delete</code></li>
<li>Fully unit-tested</li>
</ul>

Markdown for Agents and Statistics

Serve pre-generated Markdown files to AI agents via HTTP content negotiation.

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 for Agents and Statistics vs Umay AI Markdown