本主题已在 astro.config.ts 配置文件中安装并配置了 @astrojs/mdx ↗ 集成。如果您不想使用 MDX,可以从配置文件中移除该集成来禁用它。
为什么选择 MDX?#
MDX 是 Markdown 的一种特殊变体,支持嵌入 JavaScript 和 JSX 语法。这使您能够 在 Markdown 内容中混合使用 JavaScript 和 UI 组件 ↗,例如交互式图表或警告框。
如果您已有使用 MDX 编写的内容,该集成将使您迁移到 Astro 变得非常简单。
示例#
下面展示了如何在 MDX 中导入并使用 UI 组件。
当您在浏览器中打开此页面时,您应该能看到下面这个可点击的按钮。
更多链接#
- MDX 语法文档 ↗
- Astro 使用文档 ↗
- 注意: 仍需要 客户端指令 ↗ 来创建交互式组件。否则,默认情况下您的 MDX 中的所有组件都将渲染为静态 HTML(不含 JavaScript)。