讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

在VSCode中为Markdown自动生成和更新目录

夜涛同学_4276

夜涛同学_4276

发布时间:2026-01-03 17:29:02

|

273人浏览过

|

来源于php中文网

原创

VSCode 中用 Markdown All in One 插件可一键生成并自动更新目录:安装后启用 TOC 功能,通过命令“Markdown: Create Table of Contents”插入或更新,开启 autoUpdate 后保存即同步,支持层级控制与 GitHub 兼容锚点。

在vscode中为markdown自动生成和更新目录

在 VSCode 中为 Markdown 自动生成和更新目录,核心是借助插件和少量配置,无需手动维护。最常用、稳定且免费的方案是 Markdown All in One 插件,它原生支持一键生成(Ctrl+Shift+P → “Markdown: Create Table of Contents”)和自动更新(保存时或光标移动时可选)。

安装并启用 Markdown All in One

这是实现自动化目录的基础:

  • 打开 VSCode 扩展市场(Ctrl+Shift+X),搜索 “Markdown All in One”,安装并重启(如提示)
  • 安装后默认已启用,无需额外配置即可使用基础功能
  • 确认设置中未禁用 TOC 相关选项:进入 Settings → Extensions → Markdown All in One,检查 “Table of Contents: Enabled” 为开启状态

快速生成或更新目录

生成目录不依赖位置,但建议放在文档靠前处(如标题下、简介后):

git-push
git-push

自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括:自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。

下载
  • 将光标定位到你想插入目录的位置(例如 # 文档标题 下一行)
  • 按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 “Markdown: Create Table of Contents” 并回车
  • 首次运行会生成标准 TOC;再次运行同一命令,默认会 覆盖更新 原有目录(保留你手动添加的注释或格式需谨慎)

开启自动更新(可选但推荐)

避免每次改完标题都手动刷新,可启用保存时自动同步:

  • 打开设置(Ctrl+,),搜索 “markdown.extension.toc.autoUpdate”
  • 勾选该项,或在 settings.json 中添加:
    "markdown.extension.toc.autoUpdate": true
  • 启用后,只要保存文件(Ctrl+S),TOC 就会自动重新生成,匹配当前所有 # ~ ###### 标题

自定义目录行为(进阶)

如需控制层级、忽略某些标题或调整链接格式,可通过设置微调:

  • 限制最大标题级别:设 "markdown.extension.toc.levels": "2-4",只收录 ## 到 ####
  • 跳过特定标题:给标题加 HTML 注释 <!-- omit in toc -->,该行不会出现在目录中
  • 使用 GitHub 风格锚点:确保 "markdown.extension.toc.githubCompatibility": true(默认开启),保证链接在 GitHub 上也能跳转

基本上就这些。不需要写脚本、不依赖外部工具,装一个插件 + 开个开关,就能让 Markdown 目录始终和内容保持一致。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2375

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3922

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1296

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4559

2025.09.10

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

8965

2026.01.21

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

1058

2026.04.02

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3519

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3058

2023.07.27

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn