Markdown All in One 扩展需正确配置以实现实时预览、自动生成更新目录、KaTeX 数学公式渲染、语义化标题/列表快捷键及 PDF/HTML 导出功能。
如果您在使用 VSCode 编辑 Markdown 文件时发现预览不实时、目录生成失败、数学公式无法渲染或快捷键失灵，则很可能是 Markdown All in One 扩展未正确配置或功能未被充分调用。以下是激活并深度运用该扩展核心能力的操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用实时预览与同步滚动
Markdown All in One 默认启用侧边预览，但需确保编辑器与预览窗格处于联动状态，才能实现光标定位同步与即时刷新。
1、打开任意 .md 文件后，按下 Cmd+K V（Windows/Linux 为 Ctrl+K V）唤出预览窗格。
2、右键点击预览区域，在弹出菜单中勾选 Sync Scrolling 和 Auto Scroll Preview。
3、在设置中搜索 markdown.preview.scrollPreviewWithEditor，确认其值为 true。
二、自动生成与更新大纲（Table of Contents）
该扩展支持基于标题层级自动构建可点击导航目录，无需手动维护，且能响应文档结构变更。
1、将光标置于文档任意位置，按下 Cmd+Shift+P（Windows/Linux 为 Ctrl+Shift+P）打开命令面板。
2、输入 Create Table of Contents 并回车，目录将插入至光标所在行。
3、如需更新已有目录，将光标置于目录区块内，再次执行 Update Table of Contents 命令。
三、启用 LaTeX 数学公式渲染
Markdown All in One 内置 KaTeX 支持，但需开启对应配置项并使用标准语法包裹公式内容。
1、进入 VSCode 设置界面，搜索 markdown.extension.math.enabled，将其设为 true。
2、行内公式使用单个美元符包裹，例如：$E = mc^2$；独立公式使用双美元符，例如：$$\int_0^\infty e^{-x^2}dx = \frac{\sqrt{\pi}}{2}$$。
3、保存文件后，预览窗格中公式应以清晰字体正确显示，若未生效，请检查是否与其他数学渲染插件冲突。
四、快捷键批量操作标题与列表
扩展重载了原生 Markdown 编辑逻辑，提供语义化快捷键，提升结构化写作效率。
1、选中一段文本，按下 Cmd+1 ~ Cmd+6（Windows/Linux 为 Ctrl+1 ~ Ctrl+6）可一键转换为对应级别标题。
2、在段首输入 - 或 * 后按 Tab，自动补全无序列表项并缩进；输入 1. 后按 Tab，触发有序列表自动编号。
3、将光标置于列表项末尾，连续按两次 Tab 可降级嵌套，按 Shift+Tab 升级嵌套层级。
五、自定义导出为 PDF 或 HTML
借助集成的 Pandoc 或内置转换器，可将当前 Markdown 文档导出为排版规范的静态文件。
1、确保系统已安装 pandoc（推荐通过 Homebrew 安装：brew install pandoc）。
2、在命令面板中执行 Export to PDF，扩展将调用 pandoc 渲染并保存文件。
3、若未安装 pandoc，可改用内置导出：执行 Export to HTML，生成含样式内联的 HTML 文件，双击即可在浏览器中查看。
