Enable .md extension access for raw markdown source#2476
Enable .md extension access for raw markdown source#2476leighmcculloch wants to merge 10 commits into
Conversation
|
Preview is available here: |
|
Closing because it's unnecessary. Cloudflare already serves markdown when markdown is the preferred accepted content type. LLM clients can already signal that they prefer Markdown via standard HTTP content negotiation, using the With that in place, the server can return There's very little value in serving the markdown on a separate url. |
What
Add nginx configuration to intercept requests ending in .md, strip the extension, and proxy to the original host with an Accept: text/markdown header. This enables any documentation URL to be fetched with a .md extension to retrieve the raw markdown source instead of rendered HTML, leveraging Cloudflare's native markdown feature to serve the appropriate content type.
Why
The markdown extension allows documentation to be more accessible to agents and tools that need raw markdown source, particularly those making requests to Cloudflare which can detect the Accept: text/markdown header and return unrendered markdown. This is useful for indexing, processing, and integration scenarios where the structured markdown format is needed rather than the compiled HTML representation.
Follow up
Update llms.txt to link to documentation URLs with the .md extension so that LLMs and agents accessing the documentation can retrieve raw markdown source directly.