feat: serve raw markdown via .md URLs#1447
Conversation
Add a Vite plugin that makes raw .mdx source available at .md URLs (e.g. /concepts/signals.md). In dev, files are served via middleware and copied to public/. At build time, files are copied to public/ so they ship as static assets. Also updates llms.txt to point to .md URLs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
|
✅ Deploy Preview for solid-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
Would it make more sense to incorporate this into SolidBase directly? |
Hmmm, That would actually make sense yeah, I can work on something for it there and bring it here later on this week. For a quick feature I believe we could ship as a bandaid it if good just for the time being, what do you think? |
Let's leave it for now and test/verify it for docs -- thank you for making this possible. It's a good solution for the time being but I don't want to assume the SolidBase team would have a different solution or not. Glad to have a solution finally :) |
|
With something like
I believe the solution would be very similar honestly. I will start studying their repo as soon as I get a bit more of free time. But just knowing that accessing .md would be possible it make things easier. For very complex tasks my agents seems to struggle still in solidjs, something that doesn't happen on react anymore. |
|
Hi @21Chani, thanks for putting the time into this. We really appreciate the effort here. For now, we’re going to close this so we can make sure it’s implemented properly on our side. There are a few things that should be landing soon, as I'd mentioned in the issue you created #1447, and those will move us closer to the direction you're suggesting. |
Description(required)
This PR adds the ability to access the raw markdown source of any documentation page by appending
.mdto the URL (e.g.https://docs.solidjs.com/concepts/signals.md).This is useful for LLM consumption and aligns with the existing
llms.txtfile. Changes:serveRawMarkdown) inapp.config.ts: Copies.mdxfiles fromsrc/routes/topublic/as.mdat build time, so they ship as static assets. In dev, also serves them via middleware for live reloading.llms.txt: All URLs now point to.mdversions so LLMs can directly fetch raw markdown content..gitignore: Ignores the generatedpublic/**/*.mdfiles.Related issues & labels
#1440