Hamza Mairaj

BerqWP

Berq Markdown makes your WordPress content instantly consumable by AI assistants, LLM crawlers (GPTBot, ClaudeBot, Googlebot-AI), and Markdown-aware tools — without duplicating your content or creating separate pages.
Appending <code>.md</code> to any public page or post URL (e.g. <code>https://example.com/about.md</code>) returns a clean, structured Markdown file with YAML frontmatter. The plugin handles content from all common sources: Gutenberg blocks, classic editor, shortcodes, and custom PHP templates.
How it works
When a visitor or crawler requests <code>/about.md</code>, the plugin intercepts the request, finds the matching WordPress post, converts the HTML content to Markdown, and serves it with the correct <code>Content-Type: text/markdown</code> header — all without creating any new database entries or files.
Key Features
<ul>
<li>Automatic .md URLs — any public post or page URL + <code>.md</code> returns clean Markdown</li>
<li>YAML frontmatter — every .md file includes <code>title</code>, <code>description</code>, <code>url</code>, <code>date_modified</code>, <code>author</code>, and <code>language</code></li>
<li>Full content compatibility — works with Gutenberg blocks, classic editor, shortcodes, and custom PHP page templates</li>
<li>HTML to Markdown conversion — pure PHP, no external dependencies; handles headings, paragraphs, lists, links, images, tables, code blocks, and more</li>
<li>Internal link rewriting — links to internal pages are rewritten to their <code>.md</code> equivalent automatically</li>
<li>URL exclusions with wildcards — exclude specific URL patterns using <code>*</code> as a wildcard (e.g. <code>/cart/*</code>, <code>*/checkout*</code>)</li>
<li>Post type selection — choose which post types (posts, pages, custom post types) are served as Markdown</li>
<li>Transient caching — optional cache with configurable TTL to reduce server load at scale</li>
<li><code><link></code> tag injection — injects a <code><link rel="alternate" type="text/markdown"></code> tag in every page’s <code><head></code> so crawlers can discover the .md version</li>
<li><code>[btrmd313_md_link]</code> shortcode — renders a link to the current page’s <code>.md</code> file, opens in a new tab</li>
<li>Multilingual support — detects language via Polylang or WPML, adds <code>language</code> and <code>alternates</code> to frontmatter and emits <code>hreflang</code> link tags</li>
<li>Public content rendering — always renders content as a non-logged-in visitor, so member-only sections are not exposed</li>
<li>Admin settings page — all options configurable under Settings > Berq Markdown, with a Settings link on the Plugins page</li>
</ul>

Berq Markdown – Markdown Pages for AI & LLM Crawlers

Serve any WordPress page or post as a clean Markdown file optimized for AI and LLM crawlers by appending .md to the URL.

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.

Berq Markdown – Markdown Pages for AI & LLM Crawlers vs Umay AI Markdown