📜  toc中语法和语言之间的区别-任何(1)

📅  最后修改于: 2023-12-03 14:48:00.929000             🧑  作者: Mango

TOC 中语法和语言的区别-任何

在阅读markdown文件的时候,我们常常需要找到特定的标题或者章节,这时候TOC就派上了用场。TOC是Table of Contents的缩写,翻译成中文就是目录。

在markdown文件中,我们可以通过TOC来生成目录,便于我们快速跳转到所需的章节。不同的markdown编辑器在TOC的语法和生成方式上会有一些区别,下面就让我们来看看这些区别吧!

GitHub Flavored Markdown (GFM) 的 TOC 语法

在GFM中,可以通过以下语法来生成TOC:

## 目录
- [章节 1](#chapter-1)
- [章节 2](#chapter-2)
- [章节 3](#chapter-3)

## Chapter 1 <a name="chapter-1"></a>

...

## Chapter 2 <a name="chapter-2"></a>

...

## Chapter 3 <a name="chapter-3"></a>

...

在语法中我们可以指定每个章节对应的锚点名称,然后在目录中引用这些锚点名称,最终生成TOC。

Markdown All in One 的 TOC 语法

在Markdown All in One中,可以通过以下语法来生成TOC:

[[toc]]

# Chapter 1

...

# Chapter 2

...

# Chapter 3

...

在这个语法中,我们可以通过[[toc]]语法来生成TOC,非常方便。需要注意的是,在Markdown All in One中,生成的TOC默认是不带链接的,如果需要带链接的话需要加上--url参数。

VS Code 插件 Markdown TOC 的 TOC 语法

在Markdown TOC插件中,可以通过以下语法来生成TOC:

<!--TOC-->

# Chapter 1

...

# Chapter 2

...

# Chapter 3

...

在这个语法中,我们可以通过<!--TOC-->语法来生成TOC,非常方便。需要注意的是,在Markdown TOC中,生成的TOC默认是不带链接的,如果需要带链接的话需要加上--anchorClassName参数。

总结

以上就是常见markdown编辑器中TOC语法的区别了。无论是哪种语法,在使用时都需要注意每个章节的标题和锚点名称要保持一致。有了TOC,再也不用担心找不到特定的章节了!