14 天 Markdown 实战入门（VS Code 版）-- 第 2 章：VS Code Markdown 环境配置与必备插件

系列名：《从 0 到 1：14 天 Markdown 实战入门（VS Code 版）》
更新节奏：每天 1 章，共 14 章
本章难度：⭐⭐☆☆☆
本章关键词：VS Code 插件、Markdown All in One、Markdown Preview Enhanced、markdownlint、Paste Image

1. 本章导读

上一章我们安装了 VS Code，并成功新建了第一个 .md 文件，还用内置预览看到了 Markdown 的渲染效果。

但如果你真的准备长期用 Markdown 写博客、写文档、写笔记，只靠 VS Code 内置功能还不够。你会遇到这些问题：

• 想自动生成文章目录，怎么办？
• 想粘贴截图并自动保存到指定目录，怎么办？
• 想检查 Markdown 语法是否规范，怎么办？
• 想导出 PDF、HTML，或者获得更漂亮的预览，怎么办？
• 想统一团队写作风格，怎么办？

这一章我们就来搭建一套顺手的 Markdown 写作环境。你会学到如何安装插件、如何配置 VS Code，以及如何把它们组合成一个适合写博客和文档的工作区。

2. 学习目标

完成本章后，你应当能够：

• 理解 VS Code 插件在 Markdown 写作中的作用。
• 安装并配置常用 Markdown 插件。
• 使用 Markdown All in One 自动生成目录。
• 使用 Markdown Preview Enhanced 获得增强预览。
• 使用 markdownlint 检查 Markdown 语法规范。
• 使用 Paste Image 快速粘贴截图。
• 配置一个适合写博客的 VS Code 工作区。
• 掌握 VS Code 设置文件 settings.json 的基本写法。

3. 理论讲解

3.1 为什么需要 Markdown 插件？

VS Code 内置了对 Markdown 的基础支持，包括：

• 语法高亮
• 内置预览
• 基础快捷键
• 部分 Markdown 语法识别

但内置功能偏“基础”，缺少很多写作增强能力，例如：

• 自动生成目录
• 自动更新目录
• 数学公式增强
• Mermaid 图表预览
• 图片粘贴与路径管理
• 语法规范检查
• 拼写检查
• 导出 PDF / HTML
• GitHub 风格预览

所以我们需要安装插件，把 VS Code 从“能写 Markdown”升级为“高效写 Markdown”。

3.2 常用 Markdown 插件分类

可以按功能把插件分成几类：

本章重点安装和配置前五个，其余插件你可以按需选择。

3.3 插件安装原则

不要一次性安装几十个插件。建议遵循：

1. 按需安装：先安装最常用的，遇到问题再补。
2. 避免功能冲突：多个预览插件可能互相干扰。
3. 关注维护状态：优先选择下载量大、更新频繁的插件。
4. 工作区隔离：不同项目可以在 .vscode/settings.json 中单独配置。
5. 配置可版本化：把工作区配置提交到 Git，方便团队统一。

4. VS Code 实操：安装必备插件

4.1 打开扩展面板

方式一：点击左侧活动栏的“扩展”图标。

方式二：使用快捷键：

• Windows / Linux：Ctrl + Shift + X
• macOS：Cmd + Shift + X

方式三：命令面板输入：

Extensions: Install Extensions

4.2 安装 Markdown All in One

在扩展面板搜索：

Markdown All in One

找到作者为 Yu Zhang 的插件，点击“安装”。

主要功能：

• 快捷键加粗、斜体、删除线
• 自动生成目录
• 自动更新目录
• 列表编辑增强
• 表格格式化
• 数学公式支持
• 自动预览

常用快捷键：

4.3 安装 Markdown Preview Enhanced

搜索：

Markdown Preview Enhanced

作者为 Yiyi Wang，点击安装。