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~~ |
自動連結
Visit https://nextjs.dev.org.tw.
自訂標題 ID
您可以使用 ## 我的標題 [#custom-id]
的格式指定自訂標題 ID。例如
Markdown
## Long heading about Nextra [#about-nextra]
在此範例中,#about-nextra
將會被用作標題連結,取代預設的 #long-heading-about-nextra
。