<p>Mermaid Preview导出无右键选项是因文件未识别为Mermaid语言模式，需配置files.associations、使用.mmd后缀或严格mermaid代码块并重启VS Code。</p>
Mermaid Preview 导出 PNG/SVG 为什么右键没选项
不是插件没装，而是文件没被识别为 Mermaid 语言模式。常见原因有三个：files.associations 没配、后缀名不是 .mmd 或 .mermaid、代码块没写对格式。
- 检查设置中是否已添加：
"*.mmd": "mermaid"和"*.mermaid": "mermaid" - 确保文件后缀是
.mmd（推荐），或在.md文件里用严格格式写代码块：```mermaid开头，```结尾，中间不能有多余空行或缩进 - 改完设置或文件后，必须重启 VS Code——插件不会热重载语言关联规则
Draw.io Integration 导出 PNG 清晰度低怎么办
导出模糊本质是缩放渲染未生效，不是 DPI 设置问题。插件内嵌的 draw.io 编辑器默认以 100% 缩放渲染，直接导出等于“按屏幕像素截图”，字小图糊。
- 导出前务必先点编辑器右上角
Zoom→ 调到200%或300%（Mac 用Cmd + =，Windows/Linux 用Ctrl + =） - 导出时勾选
Transparent background，避免白边干扰排版 - 禁用插件设置里的
Enable cloud sync和Allow loading remote images，这两项会干扰本地渲染一致性
Markdown PDF 插件导出流程图时字体/中文乱码
vscode-markdown-pdf 默认用 Chromium 渲染，但不自动加载系统中文字体。Mermaid 图表里的中文、箭头标签、节点文字全靠 CSS fallback 控制，不是换字体就能解决。
- 在项目根目录建
markdown-pdf.css，显式声明字体栈：body { font-family: "Noto Sans CJK SC", "PingFang SC", "Microsoft YaHei", sans-serif; } - 配置
markdown-pdf.styles指向该文件路径，注意是相对路径（如["./markdown-pdf.css"]） - 不要依赖插件自带的“中文字体支持”开关——它只影响 Markdown 正文，不影响 Mermaid 渲染层
导出 SVG 后粘贴进 Word/PPT 显示异常
SVG 是矢量格式没错，但 Office 系列对 SVG 的解析能力有限，尤其含 <foreignObject> 或复杂滤镜的 Mermaid 输出，容易崩样式或丢文字。
- 优先用浏览器打开导出的 SVG（Chrome/Firefox），再右键“图片另存为 PNG”——此时浏览器按当前缩放渲染，比插件直出清晰得多
- 若必须用 SVG，导出前在 Mermaid 代码顶部加声明：
%%{init: {'theme': 'base', 'fontFamily': 'sans-serif'}}%%，禁用主题字体和阴影等易出错特性 - Word 2019+ 支持 SVG，但需关闭“压缩图片”选项（文件 → 选项 → 高级 → 图像大小和质量 → 取消勾选）
导出这件事，真正卡住人的从来不是按钮在哪，而是每个插件对“格式”“缩放”“字体上下文”的理解完全不同。同一张图，Mermaid Preview 认为该按视口缩放，Draw.io Integration 认为该按画布 DPI，而 Markdown PDF 又把所有东西扔给 Chromium 渲染——你得先看清谁在控制哪一层，再动设置。
