在使用 markdown 进行写作的过程中,有时文章里子标题的级别较深,会导致在部分网站上渲染出来的字体太小,不同级别的标题之间的差别也很难区分,造成不舒服的阅读体验。
在几番搜索和尝试后,找到了这个插件 markdown_index,运行插件 > markdown add index
即可为文章的所有标题自动添加多级序号,非常方便。但插件的作者是将标题序号从一级标题开始编号的,若我们写文档时习惯将所有标题都作为一级标题 #
的子标题(比如我。。),就会造成所有标题序号前都带了 1.
却实则没有意义,于是便花了点时间动动手,修补了一个 issue 并增加了配置项可供用户进行设置:
假设有这样的一篇文档
# a
foolbar
## a-b
foolbar
## a-c
foolbar
### a-c-d
foolbar
## a-e
foolbar
若保持默认设置:
markdownIndex.indexBase = '#'
,则运行插件后是这样的效果# 1. a foolbar ## 1.1. a-b foolbar ## 1.2. a-c foolbar ### 1.2.1. a-c-d foolbar ## 1.3. a-e foolbar
若修改设置:
markdownIndex.indexBase = '##'
,则运行插件后是这样的效果# a foolbar ## 1. a-b foolbar ## 2. a-c foolbar ### 2.1. a-c-d foolbar ## 3. a-e foolbar
修改后的插件可在这里下载,下载 vsix 文件后在 vscode 里安装即可。