wtf is starlight-dot-md?

Starlight-dot-md is a plugin that makes your documentation accessible to AI agents in a format they can actually use. If you run a documentation site built with Astro Starlight, this tool lets any AI assistant read your docs as raw markdown instead of trying to parse a rendered web page. Normally, when someone visits your docs site, they see a nicely formatted web page with navigation bars, styling, and other browser-friendly elements. That's great for humans but messy for AI tools that work better with plain text. This plugin solves that by creating a simple alternative: append .md to any page URL and you get the underlying markdown source file instead of the formatted HTML. So a page at /guides/getting-started becomes available at /guides/getting-started.md as clean, unstyled markdown. The people who benefit most here are teams whose docs are meant to be consumed by AI-powered tools. If you run an open-source project and want coding assistants like GitHub Copilot or ChatGPT to understand your API documentation, this gives them a direct path to read it accurately. Product teams building internal tools on top of AI agents could also use it to let those agents pull fresh documentation without scraping HTML and guessing at structure. Setup is minimal. You install the package, add one line to your Astro configuration file to enable the plugin, and it works automatically across all your documentation pages. There are no extra endpoints to maintain or content to duplicate. The README doesn't go into detail about edge cases or performance considerations, but the core idea is straightforward: serve the same content two ways, one for humans and one for machines.