【vscode 插件】为 markdown 文章标题自动添加多级序号

在使用 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 里安装即可。

猜你喜欢

转载自blog.csdn.net/jqsad/article/details/79255727