如何格式化VS Code中Markdown代码块内容

在VS Code中编写Markdown文档时，代码块内容的格式规范直接影响文档的可读性，很多用户会因为代码块缩进混乱、语法对齐错误等问题影响文档质量，掌握对应的格式化方法能大幅提升编写效率。

使用VS Code内置功能格式化

VS Code本身自带基础的Markdown格式化能力，不需要安装额外插件就能完成简单的代码块调整。首先打开需要格式化的Markdown文件，将光标定位到目标代码块内部，或者选中整个代码块内容，然后按下快捷键Shift+Alt+F，VS Code会自动对选中的代码块进行缩进调整和对齐优化。

如果快捷键没有生效，可以右键点击编辑区域，选择格式化文档或者格式化选中内容选项，同样可以完成基础格式化操作。不过内置功能的格式化规则比较固定，对复杂代码块的支持有限，适合处理简单的文本类代码块。

通过插件实现更精准的格式化

Prettier插件配置

Prettier是前端领域常用的格式化工具，也支持Markdown文件的格式化，能够对代码块内容做更细致的规则调整。首先打开VS Code的扩展面板，搜索安装Prettier - Code formatter插件，安装完成后打开设置面板，搜索prettier相关配置项。

需要重点配置prettier.markdown.embeddedLanguageFormatting选项，将其设置为auto，这样Prettier会自动识别Markdown代码块中的内嵌语言，按照对应语言的格式化规则处理代码块内容。比如代码块标记为javascript，就会按照JavaScript的语法规则格式化内容。

配置完成后，同样使用Shift+Alt+F快捷键，就能调用Prettier对Markdown代码块进行格式化，以下是简单的配置示例：

{
  "prettier.markdown.embeddedLanguageFormatting": "auto",
  "prettier.tabWidth": 2,
  "prettier.semi": false,
  "prettier.singleQuote": true
}

Markdownlint插件辅助

Markdownlint插件主要用于校验Markdown文档的语法规范，也能辅助代码块的格式统一。安装插件后，可以在项目根目录创建.markdownlint.json配置文件，设置代码块相关的校验规则，比如要求代码块必须有语言标记、缩进统一为2空格等。

当代码块内容不符合规则时，插件会在编辑器中给出提示，用户可以根据提示手动调整，或者配合格式化插件自动修正问题。以下是常用的代码块相关配置示例：

{
  "MD040": true,
  "MD031": { "list_items": true },
  "default": "consistent"
}

自定义格式化规则适配特殊需求

如果有特殊的代码块格式化需求，比如要求特定语言的代码块使用4空格缩进，或者不需要自动添加分号，可以在VS Code的设置中针对对应语言做单独配置。打开设置面板，搜索[markdown]，在JSON配置中添加对应规则。

比如要求Markdown中的Python代码块使用4空格缩进，JavaScript代码块使用2空格缩进，可以添加如下配置：

{
  "[markdown]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode",
    "editor.rulers": [80],
    "editor.tabSize": 2
  },
  "prettier.overrides": [
    {
      "files": "*.md",
      "options": {
        "embeddedLanguageFormatting": "auto"
      }
    }
  ]
}

常见问题处理

有时候格式化后代码块的语法高亮会消失，这通常是因为代码块的语言标记写错了，比如把javascript写成了js，需要检查代码块开头的语言标识是否正确。如果格式化后代码块内容出现乱码，需要检查文件的编码格式，建议统一使用UTF-8编码。

另外如果同时使用多个格式化插件，可能会出现规则冲突的情况，这时候需要在设置中指定Markdown文件的默认格式化工具，避免快捷键调用时出现混乱。可以在设置中搜索editor.defaultFormatter，将Markdown文件的默认格式化工具设置为你常用的插件即可。

VS_CodeMarkdown代码块格式化prettiermarkdownlint修改时间：2026-06-19 11:03:24