要获得专业级 Markdown 写作与实时预览体验，需在 VSCode 中安装 Markdown All in One、Markdown Preview Enhanced 和 KaTeX 扩展，启用双向同步预览，配置 KaTeX 公式渲染，自动生成目录，并优化主题与字体渲染。
如果您希望在 VSCode 中获得专业级的 Markdown 写作与实时预览体验，则需要对编辑器进行针对性配置。以下是实现该目标的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心扩展
VSCode 原生支持 Markdown 语法高亮和基础预览，但要实现写作效率提升与渲染增强，需依赖经过验证的扩展组件。这些扩展各自承担语法检查、数学公式支持、图表嵌入等独立功能，互不干扰且可按需启用。
1、点击左侧活动栏中的扩展图标（或使用快捷键 Ctrl+Shift+X）。
2、在搜索框中依次输入并安装以下三个扩展：Markdown All in One、Markdown Preview Enhanced、KaTeX。
3、安装完成后，重启 VSCode 以确保所有扩展初始化完成。
二、启用实时双向预览
Markdown Preview Enhanced 提供所见即所得的预览能力，并支持编辑区与预览区同步滚动。该功能无需手动刷新，文本修改后预览内容自动更新，显著降低上下文切换成本。
1、打开一个。md 文件，在编辑器右上角点击 “Open Preview to the Side” 按钮（图标为两个重叠矩形）。
2、在预览窗口中右键，选择 “Toggle Sync Scroll” 启用同步滚动。
3、在设置中搜索“markdown-preview-enhanced.preview.autoUpdate”，将其值设为true。
三、配置数学公式渲染
KaTeX 是轻量级数学排版引擎，比 LaTeX 渲染更快且兼容性更强。配合 Markdown Preview Enhanced，可在文档中直接书写行内或独立公式，无需额外编译步骤。
1、在 Markdown 文件中插入行内公式，格式为：$E = mc^2$。
2、插入独立公式块，使用双美元符包裹：$$int_0^infty e^{-x^2}dx = frac{sqrt{pi}}{2}$$。
3、确认预览窗口右下角显示“KaTeX”标识，表示渲染引擎已激活。
四、启用目录自动生成
Markdown All in One 内置 TOC 生成器，能根据标题层级（# 至 ######）动态创建结构化导航栏。该目录支持点击跳转，且可随文档结构调整即时更新，避免手动维护过时链接。
1、将光标置于文档任意位置，按下快捷键 Ctrl+Shift+ P 调出命令面板。
2、输入并选择“Markdown All in One: Create Table of Contents”。
3、在弹出选项中选择插入位置（推荐顶部），并勾选 “Use GitHub-compatible anchors” 以确保链接在 GitHub 页面中有效。
五、定制主题与字体渲染
默认编辑器主题对 Markdown 文本对比度不足，易导致长时间写作视觉疲劳。通过调整编辑器字体平滑方式与颜色方案，可提升代码块、引用段落及列表项的可读性。
1、进入设置（Ctrl+,），搜索“editor.fontLigatures”，将其设为 true 以启用连字支持。
2、搜索“workbench.colorTheme”，选择 “GitHub Dark Default” 主题。
3、搜索“markdown.styles”，添加自定义 CSS 路径，指向本地样式文件，其中包含 blockquote 边框加粗与 code 块背景色强化规则。
