作者
AI Note 团队
发布于
Fri Dec 20 2024
MDX 的强大功能
探索 MDX 如何将 Markdown 的简洁性与 React 组件的灵活性完美结合。
MDX 是什么?
MDX 是 Markdown 的超集,允许你在 Markdown 文档中使用 JSX 和 React 组件。
传统 Markdown
传统 Markdown 简单直接:
# 标题
这是一段文字。MDX 的魔力
但 MDX 可以做更多:
import { Alert } from '@/components/alert'
# 标题
<Alert type="info">
这是一个自定义组件!
</Alert>实际应用
1. 交互式示例
你可以在文档中嵌入实时代码示例:
function Counter() {
const [count, setCount] = useState(0);
return (
<button onClick={() => setCount(count + 1)}>
点击次数: {count}
</button>
);
}2. 数据可视化
<Chart data={salesData} type="line" />3. 条件渲染
{process.env.NODE_ENV === 'development' && (
<Warning>这是开发环境专用内容</Warning>
)}优势总结
- ✅ 保留 Markdown 的简洁性
- ✅ 获得 React 的强大功能
- ✅ 类型安全 (配合 TypeScript)
- ✅ 组件复用
MDX 是现代文档的未来!