System Markdown Alternate

System Markdown Alternate publishes a clean, machine-readable Markdown representation of your content. Append .md to any supported permalink and you get YAML front matter plus the post body converted to Markdown — with marketing clutter, forms and navigation widgets stripped out.

https://example.com/my-post/    → HTML
https://example.com/my-post.md  → Markdown (front matter + content)

It is built for the era of AI assistants, agents and technical scrapers that prefer plain Markdown over rendered HTML. It is not a generic SEO plugin.

Read the full documentation — installation, every setting in the panel, the endpoints, the shortcodes, the integrations and troubleshooting.

Key features

• .md endpoint for every supported, published, public post.
• Content negotiation: the same Markdown is returned for Accept: text/markdown or ?format=markdown requests. The Accept header is parsed with q-values, so a client that prefers HTML (higher q) still gets HTML.
• Vary: Accept on negotiable URLs, so caches and CDNs that honour it keep the HTML and Markdown representations of the same address apart. Because some page caches key by URL only and ignore Vary, the negotiated Markdown (and 406) responses are also sent non-cacheable, so safety never depends on Vary alone.
• Markdown discovery in HTML and HTTP: supported canonical pages advertise the representation with both <link rel="alternate" type="text/markdown"> in the document head and a typed Link: rel="alternate" response header. The HTTP form is also available to HEAD requests.
• Correct HTTP headers: Content-Type: text/markdown, X-Robots-Tag (default noindex, follow) and a Link: rel="canonical" back to the HTML.
• Clean conversion: Gutenberg blocks are rendered individually (no injected related/CTA blocks), excluded blocks/shortcodes/CSS classes are removed, code blocks become fenced blocks, URLs are made absolute, and an embedded video, tweet or track leaves a link to what it embeds rather than an empty gap. Clickable link cards keep their name too: the invisible overlay link such cards are built from takes the name the markup declares, instead of arriving with no text at all.
• /llms.txt endpoint (optional): an index of your content for LLMs and AI agents. An optional enriched mode (off by default) adds a site summary, a curated “Key content” section, a description for each entry and an Optional section for older posts. Another optional toggle appends the last modified date (updated: YYYY-MM-DD) to every entry, so crawlers can spot changed content without re-fetching each URL.
• Custom taxonomies in the front matter (optional, nothing selected by default): tick the taxonomies you want and their terms are added as a taxonomies: block, alphabetically ordered. Nothing is ever published automatically: a taxonomy registered by another plugin appears in the panel unticked, and taxonomies with no public term archive are labelled as internal.
• Object cache with proactive invalidation on post edit, plugin update and settings change: a persistent object cache is used when one is available, falling back to transients otherwise.
• Optional .md hit counter (off by default): counts how many times the Markdown endpoint is served, split bot vs human. Privacy by design: only aggregate daily totals are stored — no IP addresses, no user-agent strings, no per-visitor data, no cookies, no external calls.
• Page builders are handled honestly: a post rendered by Bricks, Elementor, Divi, WPBakery, Oxygen, Beaver Builder or Breakdance has no Markdown representation — its content is not in post_content, or is there as the builder’s own layout shortcodes — so it returns 404 instead of an empty or misleading document, and it stays out of /llms.txt, the alternate links and the shortcodes. Detection is per post, never per post type: a site that builds its pages with a builder while its articles stay in the ordinary editor keeps every one of those articles.
• Admin panel to choose which post types are exposed and to tune cache, exclusions and headers — no post type is exposed until you pick one. Each type shows what its published posts are actually built with (for example 12 Bricks, 3 Gutenberg), so a page builder that costs you the Markdown version is visible before it surprises you.
• Shortcodes [sysmda_md_url] (the Markdown URL), [sysmda_md_download] (a bare download link), and [sysmda_md_actions] (an opt-in Copy as Markdown split button with copy, new-tab view and download actions).
• Optional integrations, shown only when the related plugin is active:
  • Advanced Custom Fields: add a subtitle and a TL;DR (from ACF fields) as a preamble between the H1 and the body.
  • GenerateBlocks 2.x: a {{sysmda_md_url}} Dynamic Tag, available automatically, usable in element fields (e.g. a Button URL).
• Developer-extensible: every behaviour above — which content is served, the headers, the caching, the conversion pipeline, the front matter and /llms.txt — is exposed as a WordPress filter. See the FAQ below for examples and a link to the full documented list.