VSCode的Markdownlint：规范你的Markdown文档风格_网络技术

发布时间 - 2026-01-04 00:00:00 点击率：次

配置 Markdownlint 插件可规范 VSCode 中 Markdown 文档风格：一、安装插件；二、启用内置规则实时校验；三、通过 .markdownlint.json 自定义规则；四、设置保存时自动修复。

如果您在使用 VSCode 编辑 Markdown 文件时发现格式混乱、语法不一致或团队协作中风格难以统一，则可能是由于缺乏标准化的校验与提示机制。以下是配置并使用 Markdownlint 插件规范文档风格的具体操作步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装 Markdownlint 插件

Markdownlint 是一个基于规则的静态分析工具，它通过预设或自定义的规则集检查 Markdown 文件中的常见问题，如空行缺失、列表缩进错误、标题层级跳变等，从而保障文档结构清晰、风格统一。

1、打开 VSCode，点击左侧活动栏的扩展图标（四个方块组成的图标）。

2、在扩展市场搜索框中输入 markdownlint。

3、在搜索结果中找到作者为 David Anson 的官方插件，点击“安装”按钮。

4、安装完成后，无需重启 VSCode，插件即刻生效。

插件默认启用一组通用规则（如 MD001 标题层级、MD025 单个一级标题等），可在保存或编辑时自动标记违规项，帮助用户即时识别并修正格式偏差。

1、新建或打开一个 .md 文件，例如 README.md。

2、在文档中输入不符合规范的内容，例如连续两个空行后直接写二级标题。

3、VSCode 编辑器右侧将出现波浪线提示，鼠标悬停可查看具体规则编号和说明，例如 MD012: Multiple consecutive blank lines。

4、点击波浪线下方的灯泡图标，选择“快速修复”或手动修改以消除警告。

通过创建本地规则配置文件，可关闭不适用的规则、调整参数阈值或启用额外检查项，使校验逻辑贴合项目实际需求。

1、在项目根目录下新建文件，命名为 .markdownlint.json。

2、在该文件中写入 JSON 格式规则配置，例如禁用 MD013（行长度限制）并要求列表项后必须有空行：

3、{ "MD013": false, "MD032": true }。

4、保存后，VSCode 中所有 Markdown 文件将立即应用该配置进行校验。

借助 VSCode 的代码操作功能，可将部分可自动修复的规则绑定至文件保存动作，减少手动干预，提升编辑效率。

1、按下 Cmd + ,（Mac）或 Ctrl + ,（Windows/Linux）打开设置界面。

2、在搜索框中输入 format on save，勾选“Editor: Format On Save”选项。

3、在设置中搜索 default formatter，找到“Markdown: Default Formatter”，将其设置为 DavidAnson.vscode-markdownlint。

4、保存任意 .md 文件时，支持自动修复的规则（如 MD009、MD024）将被即时应用。