[vscode] markdown_index----可以为你的markdown标题添加序号的插件

超、凢脫俗 2022-05-16 02:09 574阅读 0赞

# markdown\_index #

在使用 markdown 进行写作的过程中，有时文章里子标题的级别较深，会导致在部分网站上渲染出来的字体太小，不同级别的标题之间的差别也很难区分，造成不舒服的阅读体验。

在几番搜索和尝试后，找到了这个插件 [markdown\_index][markdown_index]，运行插件 `> markdown add index` 即可为文章的所有标题自动添加多级序号，非常方便。但插件的作者是将标题序号从一级标题开始编号的，若我们写文档时习惯将所有标题都作为一级标题 `#` 的子标题（比如我。。），就会造成所有标题序号前都带了 `1.` 却实则没有意义，于是便花了点时间动动手，修补了一个 [issue][] 并增加了配置项可供用户进行设置：

markdown\_index是一个可以为你的markdown标题添加序号的插件。 假设原文如下所示：

1.  `# a`
2.  `foolbar`
3.   
4.  `## a-b`
5.  `foolbar`
6.   
7.  `## a-c`
8.  `foolbar`
9.  `foolbar`
10.  
11. `### a-c-d`
12. `foolbar`
13.  
14. `## a-e`
15. `foolbar`
16.  
17. `# f`
18. `foolbar`

安装markdown\_index，运行 `> markdown add index`，即可自动添加序号，如下所示：

1.  `# 1. a`
2.  `foolbar`
3.   
4.  `## 1.1. a-b`
5.  `foolbar`
6.   
7.  `## 1.2. a-c`
8.  `foolbar`
9.  `foolbar`
10.  
11. `### 1.2.1. a-c-d`
12. `foolbar`
13.  
14. `## 1.3. a-e`
15. `foolbar`
16.  
17. `# 2. f`
18. `foolbar`

注：重复运行命令可以自动更新序号。 注：仅对“\#”标记的标题等级有效。 github: [https://github.com/legendmohe/markdown\_index][markdown_index]  
email: legendmohe@foxmail.com

[markdown_index]: https://github.com/legendmohe/markdown_index
[issue]: https://github.com/legendmohe/markdown_index/issues/2