System Markdown Alternate
Every published post gets a second, machine-readable representation. Append
.md to any permalink.The idea
Section titled “The idea”https://example.com/my-post/ → HTML, for peoplehttps://example.com/my-post.md → Markdown, for machinesNo second copy of your content, no build step, no change to the HTML page. The Markdown is generated on request from your blocks — so the navigation, the cookie banner, the related-posts widget and everything else injected into the page never enter it.
Start here
Section titled “Start here”| What System Markdown Alternate does | The concept, the output format, and what it deliberately is not |
| Serving your first Markdown file | Install, enable one content type, confirm it works |
| Enabled content types | The one setting the plugin cannot work without |
| Excluding content | Forms, tables of contents and other page furniture |
Also worth knowing
Section titled “Also worth knowing”- The
.mdendpoint — two ways to ask for Markdown, and the HTTP contract behind them /llms.txt— one file listing your Markdown content, so an agent can find it all- Shortcodes — link to, download, or let readers copy the Markdown
- Extending with filters — thirty-two documented hooks
- Troubleshooting — when nothing is served, or a cache answers first
It creates no SEO risk
Section titled “It creates no SEO risk”Markdown responses carry X-Robots-Tag: noindex, follow and a canonical Link header pointing back at the HTML page. Search engines are told plainly which URL counts. There is no sitemap of .md URLs, for the same reason.