要在VSCode中获得专业Markdown写作体验，需安装Markdown All in One和Markdown Preview Enhanced扩展，启用实时双向预览、自动补全、自定义CSS美化及PDF/HTML一键导出功能。
如果您希望在vscode中获得接近专业markdown写作工具的体验，需要启用并调整一系列内置与扩展功能。以下是实现该目标的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装核心Markdown扩展
VSCode默认支持基础Markdown渲染，但需通过扩展增强语法提示、实时预览、导出等功能。推荐安装经广泛验证的权威扩展以确保稳定性与兼容性。
1、点击左侧活动栏中的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在搜索框中输入 Markdown All in One，找到作者为 Yu Zhang 的扩展，点击“安装”。
3、再次搜索 Markdown Preview Enhanced，安装由 Shd101wyy 开发的该扩展。
4、重启VSCode使扩展完全生效。
二、启用实时双向预览
Markdown Preview Enhanced 提供同步滚动与编辑/预览窗口联动能力，可显著提升写作效率。需手动启用对应配置项以激活该行为。
1、按下 Cmd+, 打开设置界面。
2、在右上角搜索框中输入 markdown-preview-enhanced.previewOnStartup，勾选该项。
3、继续搜索 markdown-preview-enhanced.scrollSync，确保其值为 true。
4、使用快捷键 Cmd+K V 在编辑器右侧打开预览窗格，修改左侧文档时右侧将自动同步滚动。
三、配置自动补全与快捷插入
Markdown All in One 提供常用符号与结构的快速输入支持，例如标题层级、列表、引用块等，减少重复键入。
1、在设置中搜索 markdown.extension.onTypeReformat，启用该选项。
2、输入 # 后跟文字并回车，自动转换为一级标题并添加空行。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
3、输入 - 或 * 后跟文字并回车，自动生成无序列表项。
4、输入 > 后跟文字并回车，自动创建块引用格式。
四、自定义CSS美化预览样式
默认预览样式较为简朴，可通过注入自定义CSS文件控制字体、行高、代码块配色等视觉细节，适配个人阅读习惯。
1、在工作区根目录新建文件夹 .vscode，并在其中创建文件 markdown-preview-enhanced.css。
2、在该CSS文件中写入如下规则：
body { font-family: "SF Pro Text", -apple-system, BlinkMacSystemFont, sans-serif; line-height: 1.6; }
code { background-color: #f5f5f5; padding: 2px 4px; border-radius: 3px; }
3、打开命令面板（Cmd+Shift+P），输入并选择 Markdown Preview Enhanced: Open Preview to the Side，新预览将应用该样式。
五、启用PDF与HTML一键导出
Markdown Preview Enhanced 支持将当前文档直接导出为PDF或HTML，无需切换外部工具，适合生成交付物或归档。
1、确保已安装 pandoc 和 wkhtmltopdf 命令行工具（可通过 Homebrew 安装）。
2、右键编辑器内任意位置，选择 Markdown Preview Enhanced: Export to PDF。
3、若需HTML输出，右键选择 Markdown Preview Enhanced: Export to HTML。
4、导出文件将保存在当前文档所在目录，文件名与源文件一致，仅扩展名不同。
