This theme comes with the @astrojs/mdx integration installed and configured in your astro.config.mjs config file. If you prefer not to use MDX, you can disable support by removing the integration from your config file.
Why MDX?
MDX is a special flavor of Markdown that supports embedded JavaScript & JSX syntax. This unlocks the ability to mix JavaScript and UI Components into your Markdown content for things like interactive charts or alerts.
If you have existing content authored in MDX, this integration will hopefully make migrating to Astro a breeze.
Example
The blog renderer now passes a shared component map into MDX, so you can use a few Stellar-style blocks without importing them in every file.
What is already migrated?
- Shared
StellarShelllayout - Vanilla Extract theme tokens and global styles
- Blog, wiki, columns, and notes content collections
Use inline markers like callouts to surface metadata inside a paragraph. You can also use #Astro chips inline.
Stellar-style content blocks now render as Astro components.
Notes
Base prose spacing, headings, links, tables, quotes and code blocks follow the Stellar rhythm.
Astro components now render the same tag-plugin class structure that Stellar uses.
页面如星尘归档， 组件沿轨道发光。
More Links
- MDX Syntax Documentation
- Astro Usage Documentation
- Note: Client Directives are still required to create interactive components. Otherwise, all components in your MDX will render as static HTML (no JavaScript) by default.