Skip to main content

标题

Markdown 标题

你可以使用常规的 Markdown 标题。

## Level 2 title

### Level 3 title

#### Level 4 title

Markdown 标题被显示为目录列表中的条目。

标题的 id

每个标题都有一个 id,此 id 可以自动生成,也可以明确指定。

标题的 id 能够让你链接到 Markdown 或 JSX 中的特定文档标题:

[link](#heading-id)
<Link to="#heading-id">link</Link>

自动生成的 id

默认情况下,Docusaurus 将根据标题的文本来生成标题的 id。

### Hello World 将生成 id 为 hello-world

自动生成的 id 具有 某些限制

  • 该 id 可能看起来不太好看
  • 你可能想要 修改或翻译 标题的文本而步更新现有的 id

明确设置 id

通过特殊的 Markdown 语法可以让你明确地设置 标题 id

### Hello World {#my-explicit-id}
tip

使用 write-heading-ids 这一 CLI 命令将把标题 id 显式地添加到所有 Markdown 文档中。