在VS Code里写Markdown没大纲是真难受。长文档翻来翻去写着写着就不知道自己在第几层了。这篇文章把我平时配置、使用、踩坑的经验都捋一遍从内置功能到插件增强一次性讲透。1. 内容整体设计与思路拆解1.1 核心需求解析Markdown大纲到底解决什么问题先说清楚大纲在Markdown写作里到底扮演什么角色。Markdown本身是纯文本格式写的时候靠的是语法标记比如#表示一级标题##表示二级标题。你写的时候脑子里的结构可能是清晰的但等文档写到几千行或者你需要快速跳转到某个章节去修改内容的时候问题就来了你总不可能一页一页翻吧。大纲Outline解决的就是这个痛点。它在编辑器的侧边栏或者某个面板里把你文档里的标题层级结构提取出来以树状的形式展示。你点一下某个标题光标立刻跳到对应位置。这就像一本书前面的目录你不需要从第一页翻到第一百页去找某一章。在VS Code里大纲功能不仅仅是“能看”它还可以配合折叠、快速跳转、搜索定位来使用。有些人写着写着发现自己的文档层级乱了大纲一显示立刻就能看出哪里漏了层级、哪里结构不合理。所以说大纲不只是导航工具它还是写作结构的“体检仪”。1.2 方案选型内置功能够用但插件才能谈得上“好用”VS Code本身是带大纲功能的而且对Markdown的支持在持续增强。新版的VS Code里左侧的“资源管理器”或者单独的“大纲”面板都可以显示当前文档的标题结构。但对于重度用户来说内置功能有一些明显的短板。比如内置大纲只能识别标题语法#到######但它对代码块里看起来像标题的内容会误判吗不会这一点做得不错。可是内置大纲不支持自定义Markdown标记比如有些人写文档习惯用和---来标识一级二级标题Setext风格内置大纲是不认的。另外内置大纲面板的展示形式比较单一没有目录编号、没有自动更新目录、不能一键在文档开头插入目录列表。这些短板就需要插件来补。目前最主流的两个插件一个是Markdown All in One另一个是Markdown Preview Enhanced。前者胜在轻量、集成度高目录生成、快捷键、列表操作都顺手后者功能更重主打预览增强和导出同时也带大纲能力。我个人的建议是日常写作用内置功能Markdown All in One就足够如果你经常需要导出PDF、生成漂亮文档那Markdown Preview Enhanced更合适。关于这个话题“用哪个组件”本身没有标准答案核心是你的使用场景。下文我会把每种组合的配置方式和效果都讲清楚你可以直接抄作业。2. 核心细节解析与实操要点2.1 内置大纲视图的打开与使用基础功能先吃透打开内置大纲的方法很简单左侧竖排图标栏里点击那个“大纲”图标看起来像三根横线叠着一个竖线的图案或者使用快捷键CtrlShiftOWindows/Linux和CmdShiftOMac。这个快捷键的奥妙在于它不光能打开大纲还能在大纲里快速搜索标题。不过这里有个细节需要说明CtrlShiftO在连续按的时候第一次会打开大纲面板如果你继续输入文字它会在标题列表里做模糊搜索。比如输入“安装”两个字大纲里所有包含“安装”的标题都会被过滤出来直接回车就能跳转。这个用法对长文档简直救命尤其是几十个标题混乱在一起的时候比肉眼扫快得多。大纲面板打开后默认会跟着当前光标位置滚动高亮。也就是说你的光标在文档第几段大纲面板就高亮对应标题。这个联动逻辑在长文档写作中非常有用你随时能知道自己“身在何处”。但内置大纲有一个比较隐蔽的限制它对Markdown标题的识别依赖于标准的ATX风格也就是#空格加标题文字。如果你写的是#标题没有空格VS Code大概率能识别为标题但有点冒险个别版本存在识别不稳定的情况。所以我的建议是写Markdown永远在#后面加一个空格这是纯习惯问题但在大纲和所有解析器层面都更稳妥。2.2 大纲面板的显示规则为什么有的标题不出现大纲面板不是把所有带#的文本都展示出来它有一套自己的过滤规则。最常见的是标记类型过滤。点击大纲面板顶部的过滤器图标你可以选择显示“所有符号”还是只显示“标题”。如果你选择的是“所有符号”那么文档里的代码块引用、章节标记也可能会出现。如果你选“标题”那就只有Markdown标题结构会显示。第二个规则是大纲里默认不显示代码块内部的内容。这一点我特别提一下因为很多人会在这里踩坑。有一种情况是你在代码块里写了一段示例文档里面也有#标题这些人会发现大纲里多了很多莫名其妙的条目。其实不是大纲出了问题而是代码块围栏没有闭合或者代码块语言标记写错了导致解析器把代码块当成了正文。遇到这种情况先检查代码块的围栏是否配对再看语言标记是否合法。第三个规则是层级折叠。大纲里的树状结构是可以逐级展开和折叠的。默认情况下会保持你上一次的展开状态。很多人觉得大纲乱是因为所有层级都展开了一眼望去密密麻麻。其实你完全可以把不需要的层级收起来只看一级二级标题写作时视觉压力会小很多。还有一个容易被忽略的点VS Code的工作区设置里outline.showFiles、outline.showModules之类的配置会影响大纲展示范围。如果你打开大纲发现里面不只是当前Markdown文件的标题还混入了别的符号多半是这些设置没有调到适合你的状态。在settings.json里可以根据需要关闭不想要的符号类别这个后面配置小节细说。2.3 Markdown All in One插件目录增强与快捷操作内置大纲解决的是“看到结构”的问题Markdown All in One解决的是“管理结构”的问题。这个插件我必须实名推荐它最实用的功能有三个。第一是一键生成目录Table of Contents简称TOC。在文档顶部或任意需要插入目录的位置打开命令面板CtrlShiftP输入“Markdown: Create Table of Contents”插件会在光标位置自动生成一个列表列出当前文档的所有标题层级并带上锚点链接。这个功能对长文档来说太实用了。你不需要手动维护目录因为文档标题变了之后运行同样的命令插件会问你“是否更新已有目录”选择更新目录立即同步。第二是自动更新目录。在插件设置里有一项叫markdown.extension.toc.updateOnSave默认为关闭。你把它打开后每次保存文档插件会检测有没有TOC标记如果有就自动更新。这背后的逻辑是插件通过一个特殊的HTML注释来标记目录块的位置类似!-- TOC --和!-- /TOC --更新的时候只重写这个区间的内容不会动其他部分。理解这个机制之后你就不会好奇“为什么我在目录下面手动加的内容没有被覆盖掉”。第三是列表操作和格式化。按Tab键可以把当前行变成子列表项按ShiftTab反向缩进。它在写层级嵌套的列表时极大减少手动输入空格的时间。而且它还支持粘贴链接时自动转成Markdown格式。2.4 Markdown Preview Enhanced预览、大纲与文档导出合流如果你对“所见即所得”的要求更高那Markdown Preview Enhanced以下简称MPE更对你的胃口。它的核心是一个增强型的Markdown预览但它的左侧目录能力其实也很强。安装MPE后右键选择“Markdown Preview Enhanced: Open Preview”预览页面默认会显示在右侧或全屏。在预览页面的左上角有一个目录按钮点击后会在预览页面的左侧或者顶部弹出一个文档大纲目录点击目录项可以快速滚动到对应位置。这个目录的动态效果比VS Code内置大纲面板“更可视化”因为它展示的是渲染后的效果而不是源码结构。MPE还支持在预览页面右键导出为HTML、PDF、PNG等格式。导出时它会自动把目录一并带出去这在做技术方案、课程讲义、项目文档的时候特别实用。很多团队不要求成员用专门的文档软件一篇Markdown渲染出来带目录的PDF直接可以作为正式交付文档。不过MPE有个学习成本它的配置项非常多而且文档是英文的。我建议你按需配置不要一上来就想全掌握。最关键的几个设置项就藏在后续的配置小节里。顺便提一个和MPE相关的热词markdown preview mermaid support。MPE支持Mermaid流程图语法你在Markdown里写mermaid代码块预览会自动渲染成图。这本身跟大纲没有直接关系但你要知道的是MPE渲染的目录里mermaid代码块里的标题是不会被识别为文档标题的这一点和内置大纲行为一致所以不必担心目录被代码内容污染。3. 实操过程与核心环节实现3.1 基础配置一步步把VS Code调成写作模式先说一下整体的配置思路。不要一上来就装十几个插件先用内置功能跑通流程再把最需要的插件加上去。这里我给出一个经过验证的最小配置方案。第一步检查内置大纲是否可用打开任意一个Markdown文件确认右下角语言模式是“Markdown”。如果你的文件扩展名是.md默认会是Markdown但如果文件名是.markdown或.mdown等变体需要手动确认。点击右下角的语言模式选择“Markdown”即可。然后按CtrlShiftO看是否弹出标题列表。如果弹不出来检查一下是不是在“编辑组”里切换到了非编辑器界面或者文件根本没有标题。如果文档全是纯文本没有任何#标题大纲自然是空的这是正常的。第二步安装Markdown All in One在插件市场搜索“Markdown All in One”作者是Yu Zhang安装量非常大。安装后无需重启但建议重启一次VS Code窗口确保插件激活。然后打开命令面板输入Markdown: Create Table of Contents在文档顶部插入目录。这里有个参数细节插件生成什么层级的目录是可以调整的。在设置里搜markdown.extension.toc.levels默认是1..6也就是包括所有级别的标题。如果你只想要1到3级改成1..3目录就只显示三级以内避免长文档的目录过分冗余。第三步配置自动更新目录在设置里搜markdown.extension.toc.updateOnSave勾选为always。这意味着每次CtrlS保存时插件会自动更新TOC区域。它的好处是不用你手动运行命令坏处是如果你的文档非常长、目录非常多保存时会有极短暂的卡顿。如果感觉到了卡顿可以把这项设回onTitleChange或手动兼顾性能和自动化。第四步调整大纲面板的显示内容打开设置搜索outline重点看这几个outline.showEntries控制大纲入口是否显示。outline.problems: 控制是否显示错误和警告。如果关掉大纲会更干净。outline.showFiles、outline.showFolders等在资源管理器模式下有用但对单文件Markdown写作影响不大。我个人习惯把outline.problems关闭因为大纲里出现红色波浪线的错误提示会分散注意力。3.2 用快捷键和折叠配合大纲写长文的流畅体验大纲不是光“看”的要把它嵌进你的写作流程里。我的习惯是这样的写一个长文档时先规划好标题骨架然后在大纲面板里反复点击查看结构。每写完一个小节我会用折叠功能把已完成的段落折起来保持视野里只剩下大纲和当前段落。实现折叠的快捷键折叠当前光标所在的标题下方所有内容CtrlShift[Windows/Linux/CmdShift[Mac展开当前折叠区域CtrlShift]/CmdShift]折叠所有子标题区域CtrlKCtrl0连续按展开所有子标题区域CtrlKCtrlJ这套快捷键和大纲面板配合起来就相当于你在一个“可收缩的文档树”里写作。我实测这样写一个几千行的Markdown手册比用Word或者在线文档都清爽。根源在于VS Code给了你纯文本的确定性又用折叠帮你弱化了长文档的视觉压力。顺便补充一个冷门快捷键在大纲面板里按CtrlF焦点会进入大纲顶部的搜索框输入文字过滤标题。这相当于“标题级别”的CtrlF。我经常用它来找“配置”相关的章节比滚轮翻快多了。3.3 个性配置给大纲加上字号、缩进和浏览器式导航默认大纲面板的字体和整个VS Code UI是统一的。如果你觉得大纲的文字太挤、缩进太浅可以在settings.json里覆盖面板字体。不过这里有个坑VS Code面板内部的字体控制其实更多依赖主题和整体UI缩放单独改大纲字号比较有限。更实际的做法是利用工作区设置来优化大纲的行为。在项目根目录创建一个.vscode/settings.json可以在团队中统一大纲展示规则。例如{ outline.problems.enabled: false, outline.showKeywords: false, outline.icons: true, markdown.extension.toc.levels: 1..3, markdown.extension.toc.updateOnSave: always }这些都是加工区效果。它不会污染你的用户级设置而且换了团队、换了机器也保持一致。如果你经常在多台电脑之间切换强烈建议把Markdown写作相关配置放在工作区里。另外还有一个容易被忽略的大纲面板里的图标。Markdown预览里不同级别标题有不同的#符号标识大纲面板默认会用不同的图标区分标题类型。如果你觉得图标太占地方可以把outline.icons设为false这样列表看起来更紧凑。实测紧凑模式在文档标题多的时候确实更舒服。3.4 实战案例用大纲目录写一份1万字的技术方案举一个我自己的实战案例这样你更容易理解配好之后整个写作流程的节奏。当时要给一个项目写技术选型方案预计篇幅1万字以上里面涉及背景、现状分析、方案A/B/C对比、迁移计划、风险预案等。我没有先写正文而是先在空文档里把所有章节标题全部搭出来# 技术选型方案 ## 1. 项目背景 ### 1.1 现状 ### 1.2 目标 ## 2. 候选方案 ### 2.1 方案A ### 2.2 方案B ### 2.3 方案C ## 3. 对比分析 ### 3.1 性能对比 ### 3.2 成本对比 ## 4. 迁移计划 ### 4.1 迁移步骤 ### 4.2 回滚方案 ## 5. 风险与预案写完后按CtrlShiftO打开大纲里面就能看到如下结构。▸ 技术选型方案 ▸ 1. 项目背景 ▸ 2. 候选方案 ▸ 3. 对比分析 ▸ 4. 迁移计划 ▸ 5. 风险与预案然后我在文档顶部运行“Markdown: Create Table of Contents”生成了带锚点的目录。接下来我按章节逐个写正文。每写完一个三级标题下的内容就按CtrlShift[把这段折叠起来。这样在整个写作过程中我永远只看到自己正在写的内容以及大纲里的完整结构。最后写完整份文档时我不需要全局滚动检查有没有漏掉章节只需要看一眼大纲哪些标题是今天没写到的一目了然。这项工作如果不靠大纲和折叠非常容易在写第5章的时候忘记了第2章还有个小节没补。另外我在这份文档里用了MPE来预览渲染效果因为领导要看的是带表格、带格式的版本纯文本不够直观。预览时打开目录逻辑层级清清楚楚。4. 常见问题与排查技巧实录4.1 大纲面板是空的但文档明明有很多标题这是最常遇到的问题。我排查的顺序是这样的第一确认当前打开的文件是不是Markdown。如果文件扩展名不是.md但里面写的是Markdown语法VS Code不一定能识别标题。点右下角语言模式手动切换为“Markdown”。第二确认标题语法是否规范。#和标题文字之间必须有空格。如果写成了#标题部分版本能识别但保险起见加上空格。这个习惯在Typora等工具里是一致的属于Markdown通用规范。第三检查大纲面板右上角的过滤器。有时候你之前选了“仅显示工作区符号”导致当前文件的标题不显示。切换到“所有符号”或者“当前文件符号”试试。第四确认文件是否被排除在工作区之外。如果直接把文件拖进VS Code但没有加入工作区大纲面板的某些显示模式可能会异常。建议把文件所在文件夹加入工作区再试一次。4.2 目录生成后链接跳转不准或者多级目录不折叠Markdown All in One生成目录后点击链接能否准确定位取决于锚点规则。正常情况下插件会为每个标题生成一个锚点类似于#技术选型方案或#1-项目背景。但如果你在文档里自行添加了手工锚点或者标题里含有特殊字符锚点可能冲突。遇到跳转不准我的建议是把插件生成的TOC删掉重新运行一次“Create Table of Contents”让插件重新计算锚点。注意如果目录里出现重复标题插件会在锚点后面加序号例如#标题-1这是正常的点击可以定位到第二个重复标题。多级目录不折叠的问题其实不是插件的问题而是Markdown渲染器对嵌套列表的显示方式。生成的目录默认是嵌套的无序列表在预览里是可以全部展开的。如果你希望目录只显示一级调整markdown.extension.toc.levels为1..1即可。这个配置项在长文档里做“精简目录”非常实用。4.3 表格、代码块、HTML片段出现在大纲里怎么办大纲本来只应该显示标题但某些情况下表格的列名、代码块内的#注释、HTML标签的id属性会被识别为符号。这大多是因为你在大纲面板的过滤里选择了“所有符号”而不是“标题”。点击过滤器图标切换到“标题”类别试试。如果过滤器已经是“标题”但代码块里的内容还是出现在大纲里那几乎可以肯定是代码块围栏出了问题。检查代码块的开头和结尾是否都有至少三个反引号python # 这是一个代码块注释不应该出现在大纲里 print(hello)如果开头围栏和结尾围栏数量不一致比如开头用了三个反引号结尾用了四个Markdown解析器就会把后面的内容误判为代码块尚未结束可能导致后续所有内容都成了代码块。此时大纲会受到严重影响。修复围栏问题后大纲立刻恢复。 ### 4.4 中文字符和特殊符号导致大纲排序错乱 有些文档的习惯是给标题加编号比如“1.1 引言”“1.2 背景”还有用全角括号、中文冒号等。这些情况下大纲的排序仍然按标题的先后顺序不会打乱。但锚点生成可能出现URL编码问题导致跳转时把中文变成一串百分号编码。 如果你对链接的可读性有要求可以在生成TOC时选择“不使用autolink”插件会生成可读性较好的锚点。另外建议标题里的特殊符号尽量少比如不要用斜杠/、问号?因为这些符号在锚点规则里会被替换或编码不同版本解析不一致。 我的经验是标题里能用中文、数字、空格、点号就尽量只用这些。花哨的符号放正文里标题保持简单。 ### 4.5 安装了Markdown All in One但命令面板找不到TOC命令 这种情况多半是插件没有成功激活。检查插件是否在已安装列表里图标是否显示正常。如果安装但是命令不出现尝试CtrlShiftP输入“Markdown: Create Table of Contents”时注意冒号是全角还是半角各种自动补全和输入法可能干扰。 另外一个原因是语言模式不对。如果当前文件被识别成了纯文本或者其他格式Markdown插件不会激活。确认文件语言是“Markdown”后重新打开命令面板再试。 还是不行的话重启VS Code。插件市场里的东西绝大多数不需要重启就能激活但偶尔会有扩展宿主进程没有加载的情况。重启是万能药。 ### 4.6 快捷键CtrlShiftO没反应或被占用 CtrlShiftO在VS Code中默认绑定“Go to Symbol in File”在文件中转到符号也就是按标题跳转。但某些扩展可能占用这个快捷键比如输入法切换软件、远程插件等。遇到没反应有两种处理方式。 第一种是自己改快捷键。打开快捷键设置CtrlK CtrlS搜索“Go to Symbol”把绑定换成自己习惯的组合比如CtrlShiftL。改完保存立即生效。 第二种是用命令面板代替。按CtrlShiftP输入“”也可以触发基于符号的跳转不过体验比直接绑定快捷键差一点。 个人建议是保留一个高频可用的快捷键给大纲跳转因为这个操作每天用几十次不值得用低效方式代替。 ## 5. 实战工具与生态配合把Markdown写作链完整拼起来 ### 5.1 从大纲到知识管理VS Code不是只能写博客 很多人用VS Code写Markdown是为了写博客但实际在团队协作、个人知识管理、技术文档维护里大纲同样重要。比如有人用VitePress、VuePress等静态站点生成器来搭团队的知识库底层就是Markdown文件。每个md文件有清晰的标题结构生成站点后自动就有侧边栏导航。这依赖的就是Markdown大纲结构而VS Code的大纲功能提前就能帮你预览这个侧边栏。 我之前维护过一个内部文档仓库几十个md文件怎么保证每个文件的标题层级不紊乱我就是用一个笨办法每个文件开头插一个TOC然后用脚本检测所有文件的标题映射是否有关联。VS Code的大纲就是日常编辑时的手动检查工具。写得多了你会发现大纲不只是让你跳转它还在潜移默化训练你的结构化写作能力。 ### 5.2 与Markdown其他高频场景配合 热词里有不少Markdown相关的话题比如“markdown表格转换excel”、“markdown换行”、“markdown图片路径”。这些细节在大纲功能中也有交叉点。 图片路径和标题锚点类似都是Markdown里的引用机制。如果图片路径写错渲染时会显示裂图但不影响大纲。可如果文档很长你想排查所有图片链接是否有效靠大纲是不能完成的。这时可以装一个“Markdown Image Inspector”之类的辅助插件或者直接用正则搜索排查。我的习惯是写文档时把图片放在同级的images目录里用相对路径引用这样整体移动文件夹不会断链。 “markdown换行”这个问题看起来基础但和大纲有间接关系。如果一段文字末尾只有两个空格Markdown会渲染成换行但这不是新段落。如果标题之间有大段文字且换行方式混乱大纲不受影响但TOC的位置可能显得突兀。写的时候保持“空行分开段落”的规范就不会有这些困扰。 还有“markdown 方框”、“markdown 图标”这类涉及的是渲染层面的内容不是大纲功能本身。但你要知道的是大纲对标题的识别只看#开头其他修饰性的语法是否生效取决于渲染器和插件。比如MPE的预览可以渲染emoji、勾选框、图标字体等但大纲面板不会把这些“符号”当作标题。理解这个边界你就不容易疑惑“为什么大纲和预览长得不一样”。 ### 5.3 把Markdown表格转Excel大纲有没有用得上的地方 热词里有个“markdown表格转换excel”。这和大纲的关联其实不大但我可以给你一个思路如果一份Markdown文档里有很多表格且每个表格都对应一个章节标题你完全可以把“大纲”当作表格的索引。先在大纲里找到你要的表格位于哪个标题下再精准定位比用普通的全文搜索更符合人的阅读习惯。 至于表格转Excel的具体操作一般是复制Markdown表格后用支持粘贴的表格工具转换或者用脚本解析表格语法生成CSV。在线工具也不少但若是敏感数据我不建议上传网页转换直接写一个Node.js或Python小脚本处理会更稳妥。这和VS Code的大纲功能是两回事但都属于Markdown生态的常规操作。 ### 5.4 中文环境下VS Code官方下载与汉化配置 热词里高频出现“vscode官方下载”、“vscode设置中文”。这些基础问题确实值得再花点篇幅说明因为它们影响插件能否顺利安装。VS Code官方下载地址就是微软官网不要从乱七八糟的下载站拿。官网下载的安装包是原版没有捆绑安装后默认英文界面。 汉化的方法左侧扩展面板搜“Chinese (Simplified) (简体中文)”安装后右下角会弹出提示切换语言点击“Change Language and Restart”即可。或者按ShiftCtrlP输入“Configure Display Language”选择zh-cn重启后生效。 语言切换的作用不只是界面它还影响Markdown插件的部分内置文案。比如Markdown All in One生成目录时的一些提示框都会跟着界面语言走。如果你看不懂插件菜单里的英文先汉化界面再学操作效率更高。 ### 5.5 用Markdown写CSP-S等大纲笔记大纲功能的应用延伸 热词里“csp-s初赛大纲”、“ai核心素养测评大纲”、“车身域控制器知识大纲”、“大纲笔记是什么样的信息组织方式”这几个词背后都指向同一个需求用Markdown来整理知识大纲。这反而让我意识到大纲功能最大的用户群可能不是程序员而是学生、老师、知识工作者。 什么叫大纲笔记就是把结构放在第一位内容和细节放在结构之下。它的信息组织方式就是一棵树根节点是主题往下分一级、二级、三级。用Markdown表达时就是标题层级。用VS Code来复习这些大纲笔记时大纲面板就是天然的“知识树”视图。你可以快速看到整门课有哪些知识点也可以折叠已经掌握的分支把注意力聚焦在不会的地方。 比如复习CSP-S初赛你可以这样组织 markdown # CSP-S初赛复习 ## 1. 计算机基础 ### 1.1 进制转换 ### 1.2 位运算 ## 2. 算法初步 ### 2.1 排序 ### 2.2 搜索 ## 3. 数据结构 ### 3.1 栈和队列 ### 3.2 树与图写上一天后打开大纲所有章节清清楚楚。做真题时发现某一块不懂回来看大纲直接跳转比翻阅纸质笔记快得多。从我个人的测试感受来说VS Code的大纲功能在1000行以下的Markdown文档上完全没有性能压力。到了1万行以上的巨型文档展开折叠会有轻微延迟但依然可用。如果你真到了几万行的体量可能需要考虑拆分文件因为单个Markdown文件太大会影响插件性能和预览体验。5.6 配置备份与团队同步最后分享一个自己的习惯我会把.vscode/settings.json和extensions.json用于记录团队推荐的插件提交到Git仓库。新同事克隆仓库后VS Code会提示安装推荐插件并且工作区的设置自动生效。配合前面说的markdown.extension.toc.updateOnSave和outline系列配置团队里每个人写Markdown的体验是统一的不会有人说“我这里怎么没有目录”。extensions.json在.vscode目录下可以手动创建{ recommendations: [ yzhang.markdown-all-in-one, shd101wyy.markdown-preview-enhanced ] }新环境里打开这个项目的任何Markdown文件VS Code会弹出右下角提示“推荐安装扩展”。如果你长期在多个项目里写Markdown还可以考虑把清除插件数据、同步配置纳入一个开机脚本里。不过这是题外话不强求。讲到这里VS Code中Markdown大纲的基本功和进阶操作就都覆盖到了。我个人在实际写长文档时最大的感受是大纲加折叠这套组合比任何花哨的写作软件都更能让人专注。你不必一次性把所有配置都抄下来先把内置的CtrlShiftO用熟练再让Markdown All in One生成目录等发现还不够时再逐步加MPE一步步来就好。最后再分享一个小技巧给大纲面板绑定一个单独的视图位置让它显示在右侧而非左侧。在面板标题右键选择“移动到右侧”。写代码时左侧留给资源管理器右侧留大纲Markdown文档的结构感会更强。这个小改动我在用了一次之后就离不开了。