Markdown Content Negotiator for LLMs

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 Accept: text/markdown 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.

Key Features

• Content Negotiation: Automatically switches to Markdown output when requested via the Accept: text/markdown header.
• YAML Frontmatter: Includes metadata like Title, Date, Author, and Categories in a structured format.
• Performance Tracking: Provides an X-Markdown-Tokens header using standard LLM token heuristics.
• AI Metadata: Includes X-Content-Signal headers to help agents understand the nature of the document.
• Background Caching: Uses WP-Cron to pre-calculate Markdown strings, ensuring zero latency during requests.
• Admin Settings: Choose which post types to enable and configure global AI content signals.

1. Upload the markdown-content-negotiator-for-llms folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Configure your preferences under ‘Settings > AI Markdown’.

How do I test the Markdown output?

You can test it using a tool like cURL:

curl -H "Accept: text/markdown" https://your-site.com/post-slug/

How are tokens calculated?

We use a standard heuristic of ~4 characters per token to provide an estimate in the X-Markdown-Tokens header.

1.1.0

• Added WooCommerce Product support.
• Added Elementor content rendering support.
• Improved WooCommerce product data extraction (dimensions, weight, price with currency).
• Moved product templates to internal code-based generation.
• Fixed Markdown output escaping issues.

1.0.9

• Misspelling fix

1.0.7

• Refactor avoid trademark of ‘WP’

1.0.5

• Name Change & Refactor plugin

1.0.4

• Security: Implemented Late Escaping for all echoed variables and generated data.
• Security: Added nonces and strict data sanitization for admin settings.
• Standards: Full compliance with WordPress PHP Coding Standards (WPCS).
• Refactor: Added complete Docblock documentation and standardized all hook callbacks.

1.0.3

• Ability to generate markdown when post changes.

1.0.2

• Featured Image support
• Description creation

1.0.1

• Code Block Conversion Support (pre and code)

1.0.0

• Initial release.