VSCode中提升Markdown编辑效率需配置插件、快捷键、预览布局、图片路径及Git集成：安装Markdown All in One和Preview Enhanced；配置自动补全；分栏实时预览并同步滚动；设置assets目录管理图片；结合Git实现版本控制。
如果您在VSCode中编写Markdown文档时感到效率低下，可能是由于缺乏针对性的配置与插件支持。以下是提升Markdown编辑体验的多种实践方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心Markdown插件
VSCode原生支持基础Markdown预览，但功能有限；通过安装经社区验证的插件可显著增强语法高亮、实时渲染、目录导航等能力。
1、点击左侧活动栏的扩展图标（或按快捷键 ⇧⌘X）。
2、在搜索框中输入 Markdown All in One，选择由 Yu Zhang 发布的官方推荐插件并点击“安装”。
3、继续搜索 Markdown Preview Enhanced，安装该插件以获得双向滚动、数学公式、流程图及导出PDF等功能。
4、重启VSCode使插件完全生效。
二、启用智能自动补全与快捷键
合理配置快捷键和自动补全规则，能减少重复输入，加快标题、列表、引用等常用结构的创建速度。
1、打开命令面板（⇧⌘P），输入并选择“Preferences: Open Settings (JSON)”。
2、在 settings.json 中添加以下配置项：
"markdown.extension.onTypeReformat": true,
"markdown.extension.italic.indicator": "_",
"markdown.extension.list.indentationSize": 2
3、保存文件后，在编辑器中输入 - （短横加空格）即可触发无序列表自动缩进；输入 1. 将自动生成有序列表并递增编号。
三、定制侧边实时预览布局
默认预览为新标签页，频繁切换影响连贯性；通过分栏方式实现编辑与渲染同屏可见，提升写作专注度。
1、用快捷键 ⌘K ⌘\ 将当前Markdown文件所在编辑器区域垂直分割。
2、在右侧编辑器中右键文件标签，选择“Open Preview to the Side”。
3、调整左右窗格比例，使左侧代码区占约60%，右侧预览区占约40%。
4、在预览窗口中右键，勾选 Sync Scrolling 以启用双向滚动同步。
四、配置本地图片资源管理路径
直接拖拽图片插入易导致路径混乱，统一设置相对资源目录可保障文档可移植性与版本控制友好性。
1、在项目根目录下新建文件夹，命名为 assets。
2、打开VSCode设置（⌘,），搜索 markdown.extension.syntax.beforeRender。
3、点击“Edit in settings.json”，添加如下行：
"markdown.extension.media.previewPath": "./assets"
4、此后所有通过拖入或粘贴插入的图片将自动保存至 ./assets/ 目录，并生成正确相对路径引用。
五、启用Git集成与文档版本快照
Markdown常用于技术文档协作，结合VSCode内置Git工具可即时追踪修改痕迹，避免内容丢失。
1、确保项目已初始化Git仓库（可通过终端执行 git init 完成）。
2、在VSCode左侧活动栏点击源代码管理图标（或按 ⇧⌘G）。
3、编辑文档过程中，每完成一个逻辑段落，点击 + 号暂存变更，再在消息框中输入简明提交信息如“更新API参数说明”。
4、定期点击“…”菜单中的 Publish to GitHub，将本地分支推送到远程仓库。
