本文主要解决了如何为MarkDown文件添加目录的问题:
一行代码调用博客园或者CSDN或hexo-theme-3-hexo特有的功能自动添加目录。
使用VSCode为Markdown文件自动添加目录以及如何为标题自动进行多级编号
如何解决使用Toc插件生成的目录显示异常的问题
2. 文件头添加TOC指令
2.1. 博客园或本地的VSCode+Markdown Preview Enhanced
[toc]
2.2. CSDN
代码:
默认目录名为“文章目录”
@[TOC]
也可以修改目录名为“目录”
@[TOC](目录)
1
1
效果
2.3. GitHub+Hexo+hexo-theme-3-hexo
开头使用@[TOC]即可,不过这个应该需要主题支持,我用的是:3-hexo
把添加目录问题反馈给作者后,立马进行了功能添加,大赞一个。
目录问题:https://yelog.org/2019/09/24/3-hexo-toc/
Hexo置顶及排序问题
3. Markdown TOC插件
3.1. 安装Markdown TOC
需要先安装VSCode
在插件中心搜索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插件生成的目录换行异常
进入设置。
搜索EOL(end of line,即换行符),将换行符改成\r\n,否则的话目录可能会显示异常,原本应该使用换行符的,结果使用了”auto”这个字符串,使用auto这个字符串是无法换行的。
换行符使用了“auto”这个字符串导致无法正常换行。
换行符使用了“\r\n”这个字符串可以正常换行。