VSCode 的 Markdown All in One 扩展提供实时预览、快捷插入、TOC 生成及 LaTeX 渲染一体化支持;需安装扩展、用 Cmd+Shift+V 预览、Tab 表格、`代码块、Cmd+Shift+P 生成目录,并用 $ 或 $$ 包裹公式。

如果您在使用 VSCode 编辑 Markdown 文件时希望获得实时预览、快捷插入、目录生成等一体化支持,则 VSCode 的 Markdown All in One 扩展正是为此设计。以下是启用与配置该扩展的关键操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 Markdown All in One 扩展
该扩展需通过 VSCode 内置的扩展市场获取并启用,确保其处于激活状态是所有功能生效的前提。
1、打开 VSCode,点击左侧活动栏最下方的扩展图标(四个方块组成的图标)。
2、在扩展搜索框中输入 Markdown All in One。
3、在搜索结果中找到作者为 Yu Zhang 的扩展,点击“安装”按钮。
4、安装完成后点击“重新加载”或手动重启 VSCode,使扩展完全加载。
二、启用实时预览功能
Markdown All in One 默认集成预览面板,可同步显示编辑区内容的渲染效果,无需手动刷新。
1、打开任意 .md 文件,确保光标位于编辑器内。
2、按下快捷键 Ctrl+Shift+V(Windows/Linux)或 Cmd+Shift+V(macOS)。
3、预览窗口将出现在右侧或下方,随编辑内容实时更新。
三、插入表格与代码块的快捷方式
扩展提供了基于前缀触发的智能代码片段,大幅提升结构化内容输入效率。
1、在 Markdown 文件中输入 | 并连续两次按 Tab 键,自动生成三列两行表格框架。
2、输入 ``` 后回车,自动补全语言标识符并进入代码块区域。
3、输入 - [ ] 后回车,生成可勾选的任务列表项。
四、自动生成文档目录(TOC)
扩展支持基于标题层级自动生成导航目录,并可一键更新,避免手动维护出错。
1、将光标置于希望插入目录的位置,例如文件顶部或“目录”二级标题下方。
2、按下快捷键 Cmd+Shift+P(macOS)或 Ctrl+Shift+P(Windows/Linux)调出命令面板。
3、输入 Create Table of Contents 并选择对应命令。
4、目录生成后,后续增删标题只需再次执行该命令即可刷新。
五、启用数学公式与 LaTeX 渲染支持
扩展默认启用 KaTeX 支持,允许在 Markdown 中直接书写 LaTeX 语法并正确渲染公式。
1、在段落中用两个美元符号包裹行内公式,例如 $E = mc^2$。
2、对独立公式使用双美元符号换行包围,例如:$$\int_0^\infty e^{-x^2}dx$$。
3、确保设置中未禁用 markdown.extension.katex.enabled 选项(默认为 true)。










