Skip to Content
🎉 Nextra 4.0 已发布。Dima Machina 正在 寻找新的工作或咨询机会

Markdown

MDX

在 Nextra 中,content 目录下的所有 .mdx 文件都将使用 MDX 渲染,这是一种支持 React 组件的高级 Markdown 格式。

例如,你可以在 MDX 文件中这样导入和使用 React 组件:

MDX
## MDX 示例 import { useState } from 'react' export function Counter({ children }) { const [count, setCount] = useState(0) return ( <button onClick={() => setCount(prev => prev + 1)}> {children} {count} </button> ) } <Counter>**点击次数**: </Counter>

生成效果:

除了基本的 MDX 功能外,Nextra 还内置了一些高级 Markdown 特性。

GitHub 风格的 Markdown

GFM 是由 GitHub 创建的 Markdown 扩展,增加了对删除线、任务列表、表格等功能的支持。

删除线

已删除

Markdown
~~已删除~~

任务列表

  • 编写新闻稿
  • 更新网站
  • 联系媒体
Markdown
- [x] 编写新闻稿 - [ ] 更新网站 - [ ] 联系媒体

表格

语法描述测试文本
标题标题在这里
段落文本更多内容
删除线文本
Markdown
| 语法 | 描述 | 测试文本 | | :------- | :--: | -------: | | 标题 | 标题 | 在这里 | | 段落 | 文本 | 更多内容 | | 删除线 | | ~~文本~~ |

自动链接

访问 https://nextjs.org

访问 https://nextjs.org

自定义标题 ID

你可以使用 ## 我的标题 [#自定义-id] 格式来指定自定义标题 ID。 例如:

Markdown
## 关于 Nextra 的详细说明 [#about-nextra]

在这个例子中,#about-nextra 将被用作标题链接,替代默认的 #关于-nextra-的详细说明

Last updated on