Markdown All in One目录点击无效主因是中文锚点编码不匹配、标题行含不可见字符或空格、混用HTML标签及未保存文件；需配置slugifyMode为vscode、确保标题规范、保存后预览。
能，但关键不在“有没有插件”，而在你文档要服务谁、维护到什么粒度。 直接装个插件就指望它吐出完整项目维护文档，大概率会卡在中文锚点失效、标题跳转错位、忽略关键模块这三类问题上。真正的自动化，是把插件当“执行器”，把结构规范当“输入指令”。
Markdown All in One 生成的目录为什么点不动？
常见错误现象：目录项显示正常，但点击后页面没滚动到对应标题，或跳转到空白位置。
- 标题行末尾有空格或不可见字符（比如全角空格、Zero Width Space），
# 简介和# 简介生成的锚点完全不同 - 中文标题被转成 URL 编码后，VSCode 内置预览不支持直接跳转（如
#%E7%AE%80%E4%BB%8B），需启用插件的markdown.extension.toc.unicode配置项 - 标题用了 HTML 标签混写（如
# <span>简介</span>），插件无法解析语义层级，直接跳过该行 - 文件未保存就预览——VSCode 的 Markdown 预览只读取已保存文件内容，未保存的标题变更不会反映在 TOC 中
Document This 能不能直接生成 README.md？
不能直接生成完整 README，但它能快速补全你最耗时的部分：代码接口说明。
- 它只作用于光标所在函数/类的上下文，输出的是 JSDoc 注释块，不是独立 Markdown 文件
- 想导出为 README，得手动复制粘贴 + 补充非代码内容（如安装步骤、环境要求）
- 对 TypeScript 支持最好，JavaScript 次之；Python / Java 需额外配置语言服务器，否则参数类型识别不准
- 生成的注释里含
@param、@returns等标签，若后续用typedoc或jsdoc构建站点，这些就是现成源数据
Auto Markdown TOC 怎么控制只显示 H2-H3？
靠配置项 toc.levels，不是靠删标题。
- 在 VSCode 设置中搜索
toc.levels，设为"2-3"（字符串格式，不是数字数组） - 生效前提是目录由该插件命令生成，不是手写的；已有目录需重新运行
Update TOC - 若某节不想进目录（比如“致谢”“附录”），在标题前加注释：
<!-- omit from toc --> - 注意：
toc.levels控制的是“生成时包含哪些层级”，不影响已存在的低层级标题渲染，只是不把它们塞进 TOC 列表里
真正难的不是生成目录，而是让每个标题都承载明确职责：H1 是项目名，H2 是功能域，H3 是具体能力点。插件不会替你做这个判断——它只忠实地把 ## 变成 <h2>，再配上链接。结构松散的文档，自动化只会放大混乱。
