1. 按

本文主要解决了如何为MarkDown文件添加目录的问题:

  1. 一行代码调用博客园或者CSDN或hexo-theme-3-hexo特有的功能自动添加目录。
  2. 使用VSCode为Markdown文件自动添加目录以及如何为标题自动进行多级编号
  3. 如何解决使用Toc插件生成的目录显示异常的问题

2. 文件头添加TOC指令

2.1. 博客园或本地的VSCode+Markdown Preview Enhanced

[toc]
在这里插入图片描述

2.2. CSDN

  • 代码:
    默认目录名为“文章目录”
    @[TOC]
    
    也可以修改目录名为“目录”
    @[TOC](目录)
    
  • 效果
    在这里插入图片描述

2.3. GitHub+Hexo+hexo-theme-3-hexo

3. auto-markdown-toc

3.1. 安装auto-markdown-toc

需要先安装VSCode

  1. 在插件中心搜索auto-markdown-toc并安装。
    在这里插入图片描述

3.2. Toc插件使用说明

接着再用VSCode打开md文件后,点击右键唤出右键菜单后,会发现多了很多个菜单项。

3.2.1. 插入和更新目录

Markdown TOC:Insert/Update菜单项用于插入和更新目录。

3.2.2. 自动给标题添加多级排序的序号

Markdown Sections:Insert/Update菜单项用于自动给标题添加多级排序的序号。

Delete是删除的意思,剩下的带delete的两个菜单项用于删除目录或者删除多级排序。
在这里插入图片描述

3.3. 解决Toc插件生成的目录换行异常

  1. 进入设置。
    在这里插入图片描述
  2. 搜索EOL(end of line,即换行符),将换行符改成\r\n,否则的话目录可能会显示异常,原本应该使用换行符的,结果使用了auto这个字符串,使用auto这个字符串是无法换行的。
    在这里插入图片描述
    换行符使用了auto这个字符串导致无法正常换行。
    在这里插入图片描述
    换行符使用了\r\n这个字符串可以正常换行。
    在这里插入图片描述

4. 更多VSCode插件推荐

更多VSCode插件推荐,请参考:Markdown开发VSCode插件推荐

Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐