您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

Markdown 生成目录

1. 前言

目录是的整体索引,是结构的最直观表现形式。

Markdown 为目录提供了快捷方式,大大降低了目录的编排复杂度。

环境说明
考虑到 Markdown 工具之不兼容,有的直接从复制粘贴到本地不会正常,大家学习时自己动手写是肯定没问题的。本节所有实例及演示均使用 Typora 工具完成。
「TOC」是 Markdown 扩展语法,Typora 认已该扩展。

2. 语法详解

在 Markdown 中,目录非常简单,只需要在恰当的位置 [TOC] 符号,凡是以 # 定义的都会被编排到目录中。

实例 1

使用 [TOC] 文档目录导航。

[TOC]# 一级一些。。。。## 二级一些。。。。### 三级一些。。。。

渲染如下:

其 Html 如下:

<div class="md-toc" mdtype="toc"><p class="md-toc-content" role="list"><span role="listitem" class="md-toc-item md-toc-h1" data-ref="n2">  <a class="md-toc-inner" href="#一级">一级</a></span><span role="listitem" class="md-toc-item md-toc-h2" data-ref="n3">  <a class="md-toc-inner" href="#二级">二级</a></span><span role="listitem" class="md-toc-item md-toc-h3" data-ref="n4">  <a class="md-toc-inner" href="#三级">三级</a></span>
  </p></div>

尽管目录非常方便,我们也难免有目录的需求,如只一二级大等。

手动目录的就是将「列表」和「页内超」相结合。

实例 2

用列表和做出目录。

- [一级](#一级)
  - [ 1-1](#二级 1-1)  - [ 1-2](#二级 1-2)- [二级](#二级)
  - [ 2-1](#二级 2-1)  - [ 2-2](#二级 2-2)- [一级](#一级)
  - [ 1-1](#二级 1-1)  - [ 1-2](#二级 1-2)- [二级](#二级)
  - [ 2-1](#二级 2-1)  - [ 2-2](#二级 2-2)# 一级一些……## 二级 1-1一些……## 二级 1-2一些……# 二级一些……## 二级 2-1一些……## 二级 2-2一些……

其渲染如下:

3. 使用场景

目录适用于有章节的,通常用于,所以适合在网页或 PDF 中使用。

4. 小结

Markdown 使用 [toc] 目录;

当的目录无法满足需求时,我们仍可通过「页内超」的形式定义目录;

由于 Markdown 没有的概念,所以目录中无法。


联系我
置顶