Skip to main content
使用 <MDX> 组件将其子内容渲染为 MDX。标签之间的内容会像页面其余部分一样编译:标题、代码块、表格和其他组件均可正常工作。 该组件在 {...} 表达式中最为有用。表达式中的 Markdown 通常会渲染为纯 JSX 文本。将其包裹在 <MDX> 中,即可在按条件显示内容的同时保留完整的 Markdown 渲染。

示例

根据导出的变量显示不同的 Markdown 部分:
Conditional Markdown
页面上只渲染处于活动状态的分支。 你也可以在页面顶层使用 <MDX>,将一段 Markdown 内容归组为单个元素:
Block form
在块级形式中,请在开始标签后留一个空行,以便内容按块级 Markdown 解析。在表达式中,<MDX> 会去除其内容的公共前导缩进,因此你可以将其缩进以匹配周围的代码。
<MDX> 内的标题不会出现在页面的目录中。

限制

  • <MDX> 组件最多可嵌套 8 层。
  • 一个页面最多可在表达式中展开 500 个 <MDX> 片段。
超过任一限制都会导致构建失败。