VSCode Markdown写作体验可通过五步优化：一、启用原生预览增强（数学公式与滚动同步）；二、安装Markdown All in One扩展提升结构化写作；三、自定义工作区字体与行高改善阅读体验；四、用Code Spell Checker实现中英文拼写检查；五、配合Pandoc与Markdown Preview Enhanced一键导出PDF/HTML。
如果您在VSCode中编写Markdown文档，却发现排版混乱、预览卡顿或语法高亮异常，则可能是编辑器配置未针对Markdown场景优化。以下是提升VSCode Markdown写作体验的具体操作：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用原生Markdown预览增强
VSCode内置的Markdown预览默认不支持实时滚动同步与数学公式渲染，需通过设置激活高级渲染能力。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 markdown.preview.math，勾选该选项。
3、继续搜索 markdown.preview.scrollPreviewWithEditor，将其设为启用状态。
二、安装并配置Markdown All in One扩展
该扩展提供快捷键插入标题、列表、表格及自动补全功能，显著提升结构化写作效率。
1、点击左侧活动栏的扩展图标（或按 Cmd + Shift + X）。
2、在扩展市场中搜索 Markdown All in One，点击安装。
3、安装完成后，打开任意 .md 文件，使用 Ctrl + Shift + P 调出命令面板，输入 Toggle Table of Contents 生成目录。
三、自定义Markdown工作区字体与行高
默认等宽字体不利于长段落阅读，调整为比例字体并增加行高可缓解视觉疲劳。
1、在当前工作区根目录下创建 .vscode/settings.json 文件。
2、写入以下配置项：
"editor.fontFamily": "'SF Pro Text', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
"editor.lineHeight": 1.6,
3、保存文件后，重新打开Markdown文档即可生效。
四、启用实时拼写检查与语法建议
VSCode默认不校验Markdown中的自然语言拼写，需借助扩展实现上下文感知的拼写提示。
1、安装扩展 Code Spell Checker。
2、在设置中搜索 cSpell.language，将值设为 en, zh 以支持中英文混合校验。
3、右键选中文本，选择 Add Word to Workspace Dictionary 可添加专业术语至白名单。
五、配置一键导出为PDF或HTML
无需切换外部工具，直接在VSCode内完成格式转换，依赖Pandoc与对应导出插件协同工作。
1、在系统终端执行 brew install pandoc 安装转换引擎。
2、安装扩展 Markdown Preview Enhanced。
3、打开Markdown文件后，右键选择 Export to PDF 或使用快捷键 Cmd + K, P 调出导出菜单。
