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

1.2. 这是大写字母标题 QWER

1.2.1. 这是 空格测试标题


3. 插入HTML标签

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



Reference

posted @ 2021-10-20 16:05  Librarookie  阅读(498)  评论(0编辑  收藏  举报