MDX 与组件
Docusaurus 使用 MDX,可在文档中直接嵌入 React 组件、提示块、Demo。
在 MDX 中使用组件
- 在
src/components/创建 React 组件,文档中直接<MyComponent />。 @theme目录可覆盖/扩展主题组件。- 支持导出
Head组件定制页面 meta。
常用场景
- 提示块/Callout:用
:::info/warning或自定义组件。 - 代码沙箱:嵌入 CodeSandbox/StackBlitz iframe,或用定制组件。
- 选项卡/切换:使用社区组件或自定义 Tabs(官方提供示例)。
代码高亮与演示
- Prism 高亮,支持行号/高亮行。
- 可用
@docusaurus/theme-live-codeblock做可交互代码块(需配置)。
