xmlns="http://www.w3.org/2000/svg"

style="display:

Markdown（CommonMark）语法的一部分，而是由特定的

Markdown

等）提供的​扩展功能​。

1.2

工作原理

当

渲染器遇到这个标签时，它会执行以下动作：

1. 扫描全篇​：遍历文档中所有的标题标记（即#

   H6）。

2. 提取结构​：根据标题的层级（#的数量），构建一个嵌套的列表树。

3. 自动锚点​：为每个标题生成唯一的

   ID（锚点），并将就像地图。

   读者可以通过点击（例如[第一章](#chap1)），一旦你修改了章节标题或调整了段落顺序，所有的链接都需要手动修正，极易出错。

4. 自动化方式​：使用@toc，无论你如何增删改查章节，渲染器都会在下一次预览时自动重建（H1-H6）有助于爬虫理解文章的核心重点，从而可能获得更好的搜索排名。

   3.

   怎么做：实践操作指南

   虽然功能强大，但不同的平台对会自动生成在文章的侧边栏（PC

   端），但在移动端或某些主题下，@[toc]会在正文顶部生成一个嵌入式的，需使用工具生成静态链接Jekyll{:toc}需在列表项位置添加

   3.3

   避坑指南

   1. 空格问题​：在#和标题文字之间必须有一个空格（例如##

      标题），否则（H5,

      H6）会使导航栏变得臃肿，反而影响阅读。

   4.

   总结

   @toc是

   Markdown

   写作中性价比最高的指令之一。

   它以极低的成本（仅需一行代码），为你的技术文章赋予了专业的结构和流畅的导航体验。

   />

   下一步行动​：

   CSDN

   博客草稿，在第一行加上@[toc]，体验一下自动化目录带来的便捷吧！

   >

   转载声明：本文原创，转载请注明出处。