怎么在VSCode中使用Markdown Lint_VSCode Markdown规范检查与修复-VSCode-PHP中文网

vscode中markdownlint不生效，需确认安装davidanson.vscode-markdownlint插件、配置文件置于工作区根目录且为合法json、启用"markdownlint.autofixonsave":true并禁用prettier冲突。

怎么在vscode中使用markdown lint_vscode markdown规范检查与修复

VSCode 里装了 markdownlint 却没反应？不是插件坏了，而是它默认不修、不标红、不提示——得手动开关键开关，且容易被其他插件（比如 Prettier）静默覆盖。

怎么确认装的是真·Markdown Lint 插件

VSCode 扩展市场搜 “markdownlint”，结果里名字相似的很多：markdownlint-cli2、markdownlint-command、markdownlint-server 都只是命令行封装或后台服务，**不提供编辑器内实时波浪线和悬停提示**。

真正起作用的只有：DavidAnson.vscode-markdownlint（发布者是 David Anson，ID 完全匹配）。其他一概卸载，否则会干扰规则加载或语言模式识别。

打开 Extensions 面板（Ctrl+Shift+X），搜 markdownlint，只留一个 ID 是 DavidAnson.vscode-markdownlint 的
重启 VSCode，打开任意 .md 文件，输入 ## 标题 （末尾多一个空格），看是否立刻标黄提示 MD024 或 MD009
右下角状态栏点一下语言模式，确认是 markdown，不是 plaintext 或 markdown (plain)

为什么改了 .markdownlint.json 还不生效

vscode-markdownlint 只读你用 File > Open Folder 打开的那个文件夹根目录下的 .markdownlint.json（或 .markdownlint.yaml），**不会向上递归找父目录，也不会读用户 settings.json 里的 markdownlint.config 字段**。

常见失效原因：

.markdownlint.json 放在子目录（如 docs/.markdownlint.json），但工作区根是项目顶层，插件根本看不到
JSON 写错：用了单引号、末尾多逗号、加了 // 注释（JSON 不支持注释）
规则 ID 大小写写错，比如 "md013": false → 实际必须是 "MD013": false
配置里写了不可修复规则（如 MD007、MD029），却误以为能自动修

怎么让保存时自动修复可修项

默认状态下，vscode-markdownlint **只报错、不修复**。要让它动手，得同时满足三个条件：

Markdown Canvas

将Markdown文件转换为美观的HTML页面，适用于Canvas或浏览器查看。用于用户请求渲染、可视化、显示或分享Markdown文件时。

下载

在 settings.json 中启用："markdownlint.autoFixOnSave": true
确保 "editor.formatOnSave": true（否则 save 触发不了修复流程）
禁用 Prettier 的自动格式化冲突："[markdown]": { "editor.formatOnSave": false }，或改用 editor.codeActionsOnSave 精确控制

更稳妥的写法（推荐）：

{
  "markdownlint.autoFixOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.markdownlint": true
  },
  "[markdown]": {
    "editor.formatOnSave": false
  }
}

这样修复走 code action 流程，不跟 Prettier 的 format 流程打架。验证方式：保存后看波浪线是否消失，而不是内容反复“跳动”。