Markdown 目录

一、TOC

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

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

用法：[toc]

  1. 如果你想要在你的 TOC 中排除一个标题，请在你的标题 后面 添加 {ignore=true} 即可
  2. 部分平台支持，已测试typora支持， vscode-Markdown TOC插件支持（vscode原生Markdown不支持）

二、锚点链接

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

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

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

  1. 标题链接 格式为： 一个 # + 被链接标题文字;
  2. 标题链接 不能出现大写字母，大写用小写代替;
  3. 标题链接 不能出现空格 ' '，无论几个空格 ' ' ，都用一个 - 代替;
  4. 标题链接 不能出现中文符号，英文符号直接省略;
  5. 跳转与 目录名 无关，标题 和 标题链接 符合规则即可;
  6. 目录层级由缩进控制;

栗子：

无序目录：

- 跳到[正常二级标题测试](#正常二级标题测试)
  - 跳到[三级标题  空格   测试](#三级标题-空格-测试)
  - 跳到[三级标题字母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四级标题:英文"符号",'测试'



有序目录：

  1. 二级标题1
  2. 二级标题2
    1. 三级标题1
      1. 四级标题1
      2. 四级标题2
    2. 三级标题2
      1. 四级标题3

二级标题1

二级标题2

三级标题1

四级标题1

四级标题2

三级标题2

四级标题3


插入HTML标签

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



Via

posted @ 2021-10-20 16:05  Librarookie  阅读(36046)  评论(4)    收藏  举报