MDX 中的 Markdown 语法

引言

MDX 兼容绝大多数标准 Markdown 语法，让内容创作保持简洁高效。你可以像写普通 Markdown 一样书写标题、列表、代码块等。

常用 Markdown 语法示例

# 一级标题
## 二级标题

- 列表项 1
- 列表项 2

**加粗文本**，*斜体文本*，`行内代码`

// 代码块示例
console.log('Hello, MDX!');

与原生 Markdown 的差异

• MDX 支持在 Markdown 中直接嵌入 JSX/React 组件。
• 不能在代码块、行内代码、链接等 Markdown 语法内嵌入 JSX。
• 受限于 MDX 解析器，部分 Markdown 扩展语法（如脚注、表格对齐）需通过插件支持。

注意事项

• 组件标签需单独成行，不能与 Markdown 内容混写。
• 建议保持 Markdown 结构清晰，便于后续维护和组件插入。

总结

MDX 让你在享受 Markdown 简洁语法的同时，轻松扩展内容交互能力。掌握基础 Markdown 语法，是高效使用 MDX 的第一步。