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

Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐