
在 Astro 里使用 MDX
这个主题已经安装并配置好了 @astrojs/mdx 集成,相关设置写在 astro.config.mjs 里。如果你不想用 MDX,把这个集成从配置文件中删掉就可以关闭它。
为什么要用 MDX?
MDX 是 Markdown 的一种扩展写法,支持嵌入 JavaScript 和 JSX。这样一来,你就可以在 Markdown 内容里混用 JavaScript 和 UI 组件,比如做交互式图表或提示框。
如果你之前已经用 MDX 写过内容,迁移到 Astro 基本不用改什么。
示例
下面演示在 MDX 里导入并使用一个 UI 组件。 在浏览器中打开本页时,你应该能看到一个可以点击的按钮。
MDX 中嵌入的组件
更多链接
- MDX 语法文档
- Astro 使用文档
- 提醒: 想让组件具备交互能力,仍然需要配置客户端指令。否则 MDX 中的所有组件默认都会渲染成静态 HTML,不带 JavaScript。