Nextra 3.0 發布了。 了解更多
文件指南Markdown

Markdown

MDX

使用 Nextra,所有在 pages 目錄下的 .mdx 檔案都會使用 MDX 渲染,它是一種支援 React 組件的進階 Markdown 格式。

例如,您可以在 MDX 檔案中導入和使用 React 組件,如下所示

MDX
## Hello 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>**Clicks**: </Counter>

產生

除了基本的 MDX 之外,Nextra 還內建了一些進階的 Markdown 功能。

GitHub Flavored Markdown

GFM 是 GitHub 建立的 Markdown 擴充功能,增加了對刪除線、任務清單、表格等功能的支援。

刪除線

已移除

Markdown
~~removed~~

任務清單

  • 撰寫新聞稿
  • 更新網站
  • 聯絡媒體
Markdown
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

表格

語法說明測試文字
標題標題這就是
段落文字以及更多
刪除線文字
Markdown
| Syntax        | Description |   Test Text |
| :------------ | :---------: | ----------: |
| Header        |    Title    | Here's this |
| Paragraph     |    Text     |    And more |
| Strikethrough |             |    ~~Text~~ |

造訪 https://nextjs.dev.org.tw

Visit https://nextjs.dev.org.tw.

自訂標題 ID

您可以使用 ## 我的標題 [#custom-id] 的格式指定自訂標題 ID。例如

Markdown
## Long heading about Nextra [#about-nextra]

在此範例中,#about-nextra 將會被用作標題連結,取代預設的 #long-heading-about-nextra