Markdown 目录

Markdown 目录

1. TOC

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

• 用法：
  
  [toc]

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

  note:

  1. 如果你想要在你的 TOC 中排除一个标题，请在你的标题 后面 添加 {ignore=true} 即可
  2. 部分平台支持，已测试typora支持， vscode-markdownlint不支持, 由于我使用vscode编写的，所以就不展示 TOC 了

2. 手动书写目录

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

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

• 规则：

  1. 标题链接格式为： 一个# + 被链接标题
  2. 标题链接中不能出现大写字母，大写字母用小写字母代替
  3. 标题链接中不能出现空格 ，空格 用-代替。

  note:

  1. 目录排布由有序列表或无序列表控制
  2. 跳转与目录名无关，标题和标题链接符合规则即可

• 栗子：

  // 目录
  
  * [跳到1. 这是一级标题](#1-这是一级标题)
    * [跳到1.1. 这是二级标题 1-1](#11-这是二级标题-1-1)
    * [跳到1.2. 这是大写字母标题 QWER](#12-这是大写字母标题-qwer)
      * [跳到1.2.1. 这是 空格测试标题](#121-这是-空格测试标题)
  
  // 标题
  
  # 1. 这是一级标题
  
  ## 1.1. 这是二级标题 1-1
  
  ## 1.2. 这是大写字母标题 QWER
  
  ### 1.2.1. 这是 空格测试标题
  
  // 预览效果如下：
  

• 跳到1. 这是一级标题

  • 跳到1.1. 这是二级标题 1-1
  • 跳到1.2. 这是大写字母标题 QWER
    • 跳到1.2.1. 这是 空格测试标题

1. 这是一级标题

1.1. 这是二级标题 1-1

1.2. 这是大写字母标题 QWER

1.2.1. 这是 空格测试标题

3. 插入HTML标签

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

Reference

• https://www.bookstack.cn/read/mpe/zh-cn-toc.md
• http://www.imooc.com/wiki/markdownlesson/markdowntoc.html