跳到主要内容

标题

Markdown 标题​

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

## Level 2 title

### Level 3 title

#### Level 4 title

Markdown headings appear as a table of contents entry.

标题的 id​

Each heading has an id that can be automatically generated or explicitly specified.

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

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

自动生成的 id​

By default, Docusaurus will generate heading ids for you, based on the heading text. For example, ### Hello World will have id hello-world.

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

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

明确设置 id​

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

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

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