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

最新推荐文章于 2025-03-11 17:03:22 发布

__qqqqq

最新推荐文章于 2025-03-11 17:03:22 发布

阅读量1.4w

点赞数 5

分类专栏： plugin 文章标签：插件 markdown vscode 扩展 typescript

本文链接：https://blog.youkuaiyun.com/jqsad/article/details/79255727

版权

plugin 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了一款Markdown编辑插件markdown_index的使用方法及优化过程。该插件能够自动为Markdown文档中的标题添加多级序号，提高文档的条理性和可读性。文章还分享了如何根据个人需求调整序号的起始级别。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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