必须重启VSCode并启用关键功能，否则Markdown All in One无法使用；需Reload生效、有标题结构才能生成目录、用前缀+Tab触发snippets、开启Sync Scrolling实现预览同步。

装完不重启或没启用，Markdown All in One 的快捷键和命令基本等于没装。 它不是装上就自动干活的插件，必须手动触发启用、配置关键功能，否则你连目录都生成不了。

安装后必须“重新加载”VSCode才生效

很多人点完“Install”就去写 Markdown，结果 Ctrl+K Ctrl+T 没反应、输入 mdt 按 Tab 也不补全——问题八成出在这一步。

• 安装完成后，插件页右上角会出现“Reload”按钮，点它；或者手动关掉 VSCode 再打开
• 确认生效：打开一个 .md 文件，看右下角状态栏是否出现 Markdown All in One 图标（通常是个小书本）
• 不 reload 的典型表现：Markdown All in One: Toggle Preview to the Side 命令在命令面板里搜不到，或执行后无响应

Ctrl+K Ctrl+T 是生成目录的默认快捷键，但得先有标题结构

这个快捷键不会凭空造目录，它只扫描当前文档中以 # 到 ###### 开头的行。如果文档里全是段落没标题，它就什么也不干。

Markdown Table Maker

使用纯 Python（无依赖）创建、格式化、对齐、排序、转置以及在 Markdown、CSV、JSON、TSV 之间转换表格。

下载

• 确保文档里已有至少两级标题，比如 ## 简介 和 ### 安装步骤
• 光标放在想插入目录的位置（常见是文档最开头或“目录”二级标题下方），再按 Ctrl+K Ctrl+T
• 后续改了标题？用 Markdown All in One: Update Table of Contents 命令刷新，别手动删重插
• 注意：它默认不加序号，如需 “1.1” 这类编号，得额外运行 Markdown All in One: Add/Update section numbers

常用 snippets 不是自动弹出的，要靠前缀 + Tab 触发

插件内置了几十个代码片段，但不会等你打完整行才提示——它靠短前缀激活，且严格依赖 Tab 键确认，Enter 或鼠标点选都不行。

• mdt + Tab → 插入带光标占位符的 ## 标题（再按一次 Tab 跳到内容）
• mdtb + Tab → 插入三行两列表格，光标自动落在第一格
• mdc + Tab → 插入带 - [ ] 的任务项，支持后续用空格切换状态
• 如果没反应，检查当前文件语言模式是不是 Markdown（右下角显示，点它可切换）

实时预览侧边栏默认不开启同步滚动，得手动开

VSCode 自带的 Cmd+Shift+V（macOS）或 Ctrl+Shift+V（Win/Linux）只能打开基础预览，编辑时滚动不同步，看长文档非常痛苦。

• 用 Markdown All in One: Toggle Preview to the Side 命令打开预览（比原生更稳定）
• 预览窗口右上角齿轮图标 → 勾选 Sync Scrolling 和 Auto Scroll Preview
• 这两项不勾，你往上滚编辑区，预览还停在底部，根本没法对照修改
• 同步滚动对性能略有影响，但文档小于 2000 行基本无感

真正卡住人的从来不是“怎么装”，而是装完忘了 reload、目录没标题、snippets 按了 Enter 而不是 Tab、预览开了却没开同步——这几个点错一个，效率就掉回原始状态。