Markdown目錄樹、錨（anchor）和頁内跳轉

• 前言
• Markdown目錄樹
• 頁内跳轉連結
• 自定義錨

前言

在使用Markdown寫文檔時，如果文檔内容很多，我們很可能需要給文檔生成目錄樹和使用頁内跳轉。本文提供了實作這些功能的方法，并且已經在有道雲筆記中測試通過。

Markdown目錄樹

想要給文檔生成目錄樹，隻需要在文檔中增加

[TOC]

，目錄樹就會根據文檔中的h1~h6标題自動生成了。

注：

[TOC]

需要獨占一行才能生效。比如：

……

[TOC]

……

頁内跳轉連結

Markdown會自動給每一個h1~h6标題生成一個錨，其id就是标題内容。目錄樹中的每一項都是一個跳轉連結，點選後就會跳轉到其對應的錨點（即标題所在位置）。你可以點選本文檔開始處的目錄樹嘗試一下。

如果需要在目錄樹之外還要增加跳轉到某個标題的連結，則有兩種辦法可以做到：

1. 使用Markdown的文法來增加跳轉連結：“[名稱](#id)”。

2. 使用HTML文法來增加跳轉連結：“<a href=”#id”>名稱

其中的“名稱”可以随便填寫，“id”需要填寫跳轉到的标題的内容。例如如果想要增加一個到本文檔“前言”标題的跳轉連結，則需要這麼寫：

[使用Markdown文法增加的跳轉到“前言”的連結](#前言)

效果：

使用Markdown文法增加的跳轉到“前言”的連結

或者這麼寫：

<a href=”#前言”>使用HTML文法增加的跳轉到“前言”的連結 效果：

使用HTML文法增加的跳轉到“前言”的連結

自定義錨

假設我們想跳轉到文檔中的一個不是标題的位置（比如一張圖表），則需要在該位置自定義一個錨。

我們使用HTML文法來定義一個錨。可選的HTML标簽很多，比如<span>、<a>等等。本文使用<span>示例。

假設文檔中有一個作息時間表，在文檔的其他地方需要增加跳轉到此表位置的連結，那麼我們可以在此表的附近增加一行：

<span id=”表1”>名稱

注：id為必填項；“名稱”可以随便填寫，也可以不填。另外，可以給span增加其他屬性，比如顔色等等。

效果：

作息時間表

然後可以在文檔其他位置增加一個跳轉到它的連結了：

點我跳轉到作息時間表