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增加其他屬性，比如顔色等等。

效果：

作息時間表

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

​​點我跳轉到作息時間表​​

• 實作方法

• 首先，要定義想讓錨點去指定的位置标記（即這行代碼：

  )，其中“footer”隻是自己設定的該位置名稱，可以随意修改。

  Step 2：設定錨點連結

  其次，将定義好的位置标記放到要跳轉到的地方。 然後把錨點連結（即#footer）用像插入網頁連結一樣方式放在任意地方，當​​​點選這個錨點連結​​時就會跳到位置标記所在的位置。

<div id="Mark">div>這句話定義了錨點所指定的位置标記，名字為“Mark”.
[這句話是想要跳轉到Mark處的錨點連結，點選即會跳轉](#Mark).