Skip to content

fix(docs): rename JSX-using pages to .mdx#83

Merged
vazra merged 1 commit into
mainfrom
fix/docs-md-to-mdx
Apr 30, 2026
Merged

fix(docs): rename JSX-using pages to .mdx#83
vazra merged 1 commit into
mainfrom
fix/docs-md-to-mdx

Conversation

@vazra
Copy link
Copy Markdown
Owner

@vazra vazra commented Apr 30, 2026

Summary

  • .md files with import { ... } from '@astrojs/starlight/components' rendered the import as visible text and collapsed <Tabs>/<TabItem>/<LinkCard> into raw paragraphs.
  • Strip the bare import line from .md files that only use components Starlight auto-provides (Aside, Steps).
  • Rename files using Tabs/CardGrid/Card/LinkCard/LinkButton to .mdx and restore imports.

Test plan

Plain .md files were rendering raw `import { ... }` statements as text and
collapsing <Tabs>/<TabItem>/<LinkCard> into unstyled paragraphs because
Starlight only resolves these components in MDX. Strip the import line
from .md files that use only Aside/Steps (auto-provided in .md), and
rename files using Tabs/CardGrid/Card/LinkCard/LinkButton to .mdx with
imports restored. Quickstart, install pages, guides, and start pages
now render their tabs and link cards correctly.
@vazra vazra merged commit ab487c4 into main Apr 30, 2026
@vazra vazra deleted the fix/docs-md-to-mdx branch April 30, 2026 12:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant