Markdown 目錄

TOC

TOC 全稱為 Table of Content，自動列出全部標題。

• 用法：
  [toc]

  在 Markdown 中，自動生成目錄非常簡單，只需要在恰當的位置添加 [TOC] 符號，凡是以 # 定義的標題都會被編排到目錄中。

  note:

  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. 標題鏈接中不能出現空格 ，空格 用 - 代替。

  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. 這是 空格測試標題

插入HTML標簽

Markdown支持原生 HTML 語法，可以使用內聯樣式，這個就不介紹了。

Via

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