在 VSCode 中直接使用 Draw.io 绘制流程图：完整配置与优化指南
核心步骤：安装由 Hediet 开发的 Draw.io Integration 插件（版本≥1.5.0），通过右键菜单“Open Diagram”启动编辑。导出高清 PNG 需勾选“Use device pixel ratio”并调整缩放，在 Markdown 中嵌入需使用特定代码块语法，且需注意内容不会自动回写更新。
插件选择：Draw.io Integration 与 Diagrams.net Integration 有何区别？
关键在于选择正确的插件：请务必安装 Draw.io Integration，并确认作者为 Hediet。插件市场存在多个同名扩展，例如由 jgraph 维护的旧版 drawio-vscode 已停止更新，使用它打开文件会强制跳转至浏览器，完全丧失了在编辑器内直接编辑的便利性。
事实上，新版插件已更名为 Diagrams.net Integration，但在 VSCode 插件市场中搜索时，其显示名称仍为“Draw.io Integration”。安装时请仔细核对发布者为 Hediet，并确保版本号不低于 1.5.0。此版本提供了完整的 VSCode 内嵌编辑器体验，支持实时预览、完整的撤销重做（Ctrl+Z）、画布缩放以及导出 PNG 或 SVG 格式等核心功能。
请注意，安装完成后建议重启 VSCode，以确保右键菜单中正确出现“Open Diagram”这一关键选项。
如何正确打开并编辑 .drawio 格式文件？
打开方式较为特殊：不能通过直接双击或拖拽文件到编辑区来实现——必须右键单击目标文件，然后从上下文菜单中选择 Open Diagram。这一步是许多用户初次使用时遇到的主要障碍。
若右键菜单中未出现该选项，通常是由于插件未正确激活或文件关联设置失败。此时，可以尝试通过命令面板（Ctrl+Shift+P）手动操作，输入并执行 Draw.io: Open Diagram 命令。
首次打开文件时，系统通常会提示是否启用自动保存功能，强烈建议勾选启用。否则，若直接关闭编辑标签页，未保存的内容将丢失。编辑器底部的状态栏会实时显示当前缩放比例、页面尺寸及网格开关状态等信息，点击这些状态图标可快速进行相关调整。
解决导出 PNG 图片模糊问题：如何调整清晰度？
导出的图片清晰度不足是一个常见问题。默认导出设置采用 1x 渲染，在高分辨率显示器上查看时会显得模糊。解决此问题需要手动调整导出参数，请注意，这些设置并非在 VSCode 的主设置中，而是插件内部的导出逻辑。
具体操作步骤如下：导出前，使用 Ctrl+Shift+P 打开命令面板，执行 Draw.io: Export As 并选择 PNG 格式。随后弹出的导出对话框中，务必勾选 Use device pixel ratio 选项，这是保证输出图片清晰度的关键。
若勾选后仍觉得清晰度不够，可在导出前，右键点击画布背景，选择 Zoom，将画布缩放比例预先调整为 200% 或更高，然后再执行导出操作。这相当于提升了源图像的渲染分辨率。当然，如果对图像质量有极高要求，直接导出为 SVG 矢量格式是更理想的选择，该格式天生适用于嵌入文档或网页，且无限缩放不失真。
如何在 Markdown 中嵌入 Draw.io 图形并实现类似 Typora 的体验？
可以实现嵌入，但并非“所见即所得”的实时渲染，需要配合特定语法和插件功能来完成。
在 Markdown 文件中，你需要使用特定的代码块语法来包裹图形的 base64 编码内容，格式示例如下：
```drawio... ```
需注意，安装通用的 Markdown Preview Mermaid Support 类插件对此无效。必须依赖 Draw.io Integration 插件自带的功能：在编写好的上述代码块上右键，选择 Draw.io: Open Diagram from Code Block 来打开并编辑图形。
目前存在一个不便之处：在图形编辑器中所做的修改，不会自动同步更新回代码块内的 XML 内容，需要手动复制粘贴替换。因此，更稳妥的工作流是将流程图单独保存为 .drawio 文件，然后在 Markdown 中通过  的格式进行引用。不过，VSCode 的 Markdown 预览本身并不会解析此链接来显示图片，该引用主要起关联和标记作用。
另一个复杂点在于跨设备同步。.drawio 文件本质是 XML 文件，其中可能包含相对路径、字体引用，甚至本地图片的 base64 编码。在不同电脑上打开时，常会遇到样式或图形元素丢失的问题。请不要期望它能“开箱即用”，在迁移工作环境前，建议先检查文件内 dx/dy 和 gridSize 等参数是否正常。
