內容簡介
System Markdown Alternate 外掛可將您的內容轉換為乾淨且機器可讀的 Markdown 格式。透過在支援的永久連結後附加 .md，您可以獲得包含 YAML 前置資料的 Markdown 表示，並去除行銷雜訊、表單及導航小工具。
【主要功能】
• 每個支援的公開文章都有 .md 端點
• 內容協商，支援 Markdown 格式請求
• 正確的 HTTP 標頭設定
• 清晰的轉換，獨立渲染 Gutenberg 區塊
• Markdown 發現功能，支援 HTML 和 HTTP
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
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 in the document head and a typed Link: rel="alternate" response header. The HTTP form is also available to HEAD requests. When /llms.txt is enabled, the same pages also point at it with rel="describedby", the relation added by version 2 of the llms.txt specification, so an agent can find the site’s index from any article.
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.
Extra custom fields (optional, empty by default): list the post meta keys whose values belong in the document and they are appended to the body. One setting covers ACF, JetEngine, Meta Box and WordPress’s own Custom Fields box, because underneath they all store post meta — so a page whose text comes partly from a template’s fields is no longer published half missing. Nothing is detected automatically, and posts without the field keep their document and their cache validator untouched.
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, with a further breakdown naming a few known AI crawlers (ClaudeBot, GPTBot, PerplexityBot, CCBot) among the bot total. 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.
Bricks pages get a real .md: rendered through Bricks’ own API (never re-implemented), with the same excluded-shortcode/excluded-class rules as everything else, plus a new “excluded builder elements” list for Bricks chrome (forms, nav menus, share bars, tables of contents, breadcrumbs). A post switched back to Render with WordPress is unaffected. Detection is per post, never per post type: a site that builds its pages with Bricks while its articles stay in the ordinary editor keeps every one of those articles.
Other page builders are handled honestly: a post rendered by 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.
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.
