VSCode 的 Markdown All in One 扩展提供实时预览、快捷插入、目录生成与 LaTeX 公式支持；需安装启用、配置同步滚动、使用 Tab 补全标题列表、命令生成更新 TOC，并开启 math 渲染。
如果您在使用 VSCode 编辑 Markdown 文件时希望获得实时预览、快捷插入、目录生成与数学公式支持等一体化体验，则 VSCode 的 Markdown All in One 扩展正是为此设计的集成化工具。以下是启用并高效使用该扩展的关键操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装与基础启用
该扩展需通过 VSCode 扩展市场安装，并启用核心功能以激活全部能力。未启用时，部分快捷键和命令将不可用。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Markdown All in One，找到作者为 Yu Zhang 的官方扩展。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
4、新建一个 .md 文件，确认右下角状态栏出现 Markdown All in One 标识。
二、启用实时预览与同步滚动
该功能使编辑区与预览区保持内容一致且自动跟随滚动，避免手动刷新，提升写作连贯性。
1、打开任意 Markdown 文件后，按 Cmd+K V 启动侧边预览视图。
2、右键预览窗口空白处，勾选 Sync Scrolling 选项。
3、在设置中搜索 markdown.preview.scrollPreviewWithEditor，确保其值为 true。
三、快速插入标题与列表结构
扩展内置了基于缩进与符号识别的智能补全逻辑，可减少重复输入，加快大纲构建速度。
1、在空行输入 # 后跟文字，按 Tab 自动转换为一级标题并添加对应数量的 # 符号。
2、输入 - 或 1. 后按 Tab，自动补全无序/有序列表项并缩进对齐。
3、在段落末尾输入 [ ]，按 Enter 即生成可交互复选框。
四、自动生成与更新目录（TOC）
扩展通过解析文档中的标题层级，动态生成结构化目录，支持一键插入与增量更新，避免手动维护错位。
1、将光标置于希望插入目录的位置（如文档顶部或某节之后）。
2、按 Cmd+Shift+P 打开命令面板，输入 Markdown All in One: Create Table of Contents 并回车。
3、修改任一标题后，再次调用 Markdown All in One: Update Table of Contents 命令即可刷新。
五、启用 LaTeX 数学公式渲染
扩展默认支持内联与块级 LaTeX 表达式，但需确保预览设置中启用了数学公式解析引擎。
1、在设置中搜索 markdown.preview.math，将其设为 true。
2、在 Markdown 中输入内联公式：用 $...$ 包裹，例如 $E = mc^2$。
3、输入独立公式块：用 $$...$$ 包裹，换行后自动居中渲染。
