一、什么是Markdown目錄？

Markdown（簡稱md）是一種輕量級標記語言，它因其簡潔、易讀、易編寫的特點，在寫作領域得到廣泛的應用。而Markdown目錄則是指在md文檔中通過添加標題（#）和縮進來實現的目錄。

在md文檔中，要創建目錄只需要定義標題，即使用#號來定義各級標題，通過標題的縮進來對標簽進行歸類。

Markdown目錄示例

# 第一級標題
## 第二級標題
### 第三級標題
#### 第四級標題

## 第二級標題
### 第三級標題
#### 第四級標題
# 第一級標題結束

如上所示，我們可以看到在md文檔中定義的各級標題都會在目錄中顯示出來，在標題后面加上錨點鏈接的格式，用戶可以通過點擊鏈接來快速跳轉到相應的位置。

二、Markdown目錄的優點

1、結構清晰：通過添加目錄來進行版本控制，整篇文檔的結構性更清晰，對于用戶而言，可以更加快速的定位自己所需要的內容。

2、閱讀便捷：使用Markdown目錄生成的文檔可以輕松快速的尋找所需內容，省去了翻找額外內容的時間，提高了閱讀體驗。

3、易于維護：目錄與文檔內容分離，使得文章的排版和編輯更加方便，修改后目錄自動更新。

三、如何使用Markdown目錄

要讓文檔中自動生成目錄，只需要在首部添加一小段內容即可，如下所示：

具有自動生成目錄的Markdown文檔

[TOC]

# 第一部分
## 第一章
### 第一節
### 第二節
## 第二章
### 第一節
### 第二節

# 第二部分
## 第一章
### 第一節
### 第二節
## 第二章
### 第一節
### 第二節

使用[TOC]標簽就可以實現自動生成目錄了。

四、Markdown目錄在Github中的使用

Github是程序員必備的一個社交平臺，它支持md格式文件的在線查看、分享和編輯。而在Github中，用戶可以通過展開目錄快速定位內容，這需要在Github存庫時生成一個markdown渲染文件，來顯示其中的目錄。

在Github中，Markdown目錄的添加與正常的Markdown語法相同，只需要在md文件中添加標題就行。如果一次性添加多個目錄，那么可以使用循環加列表的方式將多個目錄集中在一起：

Github中的markdown目錄示例

- [第一章](#第一章)
  - [第一節](#第一節)
  - [第二節](#第二節)
- [第二章](#第二章)
  - [第一節](#第一節-1)
  - [第二節](#第二節-1)

# 第一章
## 第一節
### 第一小節
### 第二小節
## 第二節
### 第一小節
### 第二小節

# 第二章
## 第一節
### 第一小節
### 第二小節
## 第二節
### 第一小節
### 第二小節

在Github中，目錄是由前端樣式生成的。用戶只需要通過#來定義標題，Github前端渲染就可以自動識別標題，生成具有層級結構的目錄結構并實現跳轉。