Mobile wallpaper 1Mobile wallpaper 2Mobile wallpaper 3Mobile wallpaper 4
557 字
3 分钟
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. 目录层级由 缩进 控制

示例:

无序目录示例#

有序目录示例#

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

正常二级标题测试#

三级标题空格测试#

三级标题字母QWER测试asdf#

1.2.3.1四级标题:英文”符号”,‘测试’#

二级标题1#

二级标题2#

三级标题1#

四级标题1#

四级标题2#

三级标题2#

四级标题3#

插入HTML标签#

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

MarkDown中的目录
http://www.kafublog.com/posts/toc/
作者
KafuSnow•卡夫雪
发布于
2025-10-30
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时