一、TOC

TOC 全称为 Table of Content，自动列出全部标题。

在 Markdown 中，自动生成目录非常简单，只需要在恰当的位置添加 [TOC] 符号，凡是以 # 定义的标题都会被编排到目录中。

用法：[toc]

如果你想要在你的 TOC 中排除一个标题，请在你的标题 后面 添加 {ignore=true} 即可

部分平台支持，已测试typora支持， vscode-Markdown TOC插件支持（vscode原生Markdown不支持）

二、锚点链接

vscode-Markdown All in One插件， 可以直接生成目录， 内容和手写目录基本一样, 插件生成目录： Ctrl + Shift + P -> markdown all in one create table of contents（该方案会生成所有的标题目录，并按标题等级生成无序列表目录）

手写目录：手动添加目录的方法就是将「列表」和「页内超链接」相结合。（与HTML的锚点链接类似）

用法：[目录名](#标题链接)

标题链接 格式为： 一个 # + 被链接标题文字;

标题链接 不能出现大写字母，大写用小写代替;

标题链接 不能出现空格 ' '，无论几个空格 ' ' ，都用一个 - 代替;

标题链接 不能出现中文符号，英文符号直接省略;

跳转与 目录名 无关，标题 和 标题链接 符合规则即可;

目录层级由缩进控制;

栗子：

无序目录：

- 跳到[正常二级标题测试](#正常二级标题测试)

- 跳到[三级标题 空格 测试](#三级标题-空格-测试)

- 跳到[三级标题字母QWER测试asdf](#三级标题字母qwer测试asdf)

- 跳到[1.2.3.1四级标题:英文"符号",'测试'](#1231四级标题英文符号测试)

## 正常二级标题测试

### 三级标题 空格 测试

### 三级标题字母QWER测试asdf

#### 1.2.3.1四级标题:英文"符号",'测试'

有序目录：

1. [二级标题1](#二级标题1)

2. [二级标题2](#二级标题2)

1. [三级标题1](#三级标题1)

1. [四级标题1](#四级标题1)

2. [四级标题2](#四级标题2)

2. [三级标题2](#三级标题2)

1. [四级标题3](#四级标题3)

## 二级标题1

## 二级标题2

### 三级标题1

#### 四级标题1

#### 四级标题2

### 三级标题2

#### 四级标题3

预览效果如下：

无序目录：

跳到正常二级标题测试

跳到三级标题 空格 测试

跳到三级标题字母QWER测试asdf

跳到1.2.3.1四级标题:英文"符号",'测试'

正常二级标题测试

三级标题 空格 测试

三级标题字母QWER测试asdf

1.2.3.1四级标题:英文"符号",'测试'

有序目录：

二级标题1

二级标题2

三级标题1

四级标题1

四级标题2

三级标题2

四级标题3

二级标题1

二级标题2

三级标题1

四级标题1

四级标题2

三级标题2

四级标题3

插入HTML标签

Markdown支持原生 HTML 语法，可以使用内联样式，这个就不介绍了。

Via

https://www.bookstack.cn/read/mpe/zh-cn-toc.md

http://www.imooc.com/wiki/markdownlesson/markdowntoc.html