docs: improve markdown docs script #8970
Open
+1,004
−162
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
llms.txt fixes:
- Add llms.txt for Internationalized
- Add root llms.txt
- Added descriptions next to links
- Fixed links to be *.md instead of *.mdx
Markdown fixes:
- Add custom rendering for LinkButton, VersionBadge, StaticTable, GroupedPropTable, ClassAPI, InterfaceType
- Include root-level pages (index.md)
- Use unordered list for listing icons and illustrations
I've identified a few remaining gaps in the markdown output, but we can the rest later.
MCP fix:
- Include page descriptions in initial index build (now that they’re in llms.txt)
✅ Pull Request Checklist:
📝 Test Instructions:
For llms.txt and markdown fixes, check the built files.
To verify MCP fix, you'll need to build
@react-spectrum/mcp
locally and and test it with localhost:🧢 Your Project: