VS Code中markdownlint配置规则不生效的问题求助
问题背景
- VS Code版本:1.101.2(用户安装版)
- commit:
2901c5ac6db8a986a5666c3af51ff804d05af0d4 - date: 2025-06-24T20:27:15.391Z
- Electron: 35.5.1
- ElectronBuildId: 11727614
- Chromium: 134.0.6998.205
- Node.js: 22.15.1
- V8: 13.4.114.21-electron.0
- OS: Windows_NT x64 10.0.19045
- markdownlint版本:0.60.0
已在用户设置中配置:
"markdownlint.config": { "MD013": false, "MD025": false, },
但仍触发错误提示:
MD013/line-length: Line length [Expected: 80; Actual: 129] markdownlint MD013MD025/single-title/single-h1: Multiple top-level headings in the same document markdownlint MD025
尝试在文件中使用<!-- markdownlint-disable MD013 MD025 -->注释可成功禁用规则,但用户设置配置的方式无效。
可能的原因及解决办法
- 检查设置优先级:工作区设置优先级高于用户设置,如果当前项目的工作区设置里单独配置了markdownlint规则,会覆盖用户设置。打开VS Code设置,切换到「用户」标签页确认配置正确保存,同时检查「工作区」标签页是否有冲突规则。
- 修正配置格式:你的配置末尾多了一个冗余逗号,虽然JSON允许容错,但可能导致解析异常。修改为以下格式后保存并重启VS Code:
"markdownlint.config": { "MD013": false, "MD025": false } - 检查本地配置文件:项目根目录下如果存在
.markdownlint.json、.markdownlintrc这类本地配置文件,它们的优先级高于用户设置。需要修改本地文件中的规则,或者删除本地配置让用户设置生效。 - 重置扩展设置:打开VS Code扩展面板,找到markdownlint扩展,点击右侧齿轮图标选择「设置」,滚动到底部点击「重置所有设置」,之后重新添加规则配置并保存。
内容的提问来源于stack exchange,提问作者李俊辉
相关产品推荐
相关产品推荐

