必须手动配置udl并安装官方版markdownviewer++，缺一不可；否则语法高亮失效（灰底黑字）或预览白屏。需将markdown.default.udl.xml放入%appdata%\notepad++\userdefinelangs\，重启后右键→language→markdown→markdown.default，并确保文件已保存、路径无中文空格、插件版本匹配、autorefresh=1。

必须手动配 UDL + 必须装官方版 MarkdownViewer++，缺一不可；否则要么灰底黑字，要么白屏静默。

Notepad++ 语言模式不设为 Markdown，语法高亮就失效

不是文件名叫 readme.md 就自动高亮——Notepad++ 默认根本不识别 Markdown 语法结构。它靠“语言模式”触发 UDL（用户定义语言）规则。

• 右键编辑区 → Language → Markdown → markdown.default（不是随便点个 “Markdown” 就行，得选对具体项）
• 若菜单里没出现 markdown.default，说明 UDL 文件没导入成功：需把 markdown.default.udl.xml 放到 %AppData%\Notepad++\userDefineLangs\ 目录下（目录不存在就新建）
• 重启 Notepad++ 后仍不生效？检查是否误点了 Text 或 Plain text 模式——这种情况下哪怕后缀是 .md，也只会显示灰色文字

MarkdownViewer++ 白屏？四个前提一个都不能少

插件不报错、不弹窗，只给你一张白纸——这是它最典型的失败表现。原因几乎总是以下四点之一：

Markdown Converter 1.0.0

使用 markitdown 将文档和文件转换为 Markdown。适用于转换 PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML 等格式。

下载

• 文件**未保存**：临时文档（new 1 标签页）不会触发预览，必须先存成 .md 或 .markdown
• 语言模式没设对：即使扩展名正确，Language 若仍是 Text，预览面板直接跳过渲染
• 路径含中文或空格：例如 D:\我的笔记\test.md 会导致 URL 编码失败，控制台报 net::ERR_INVALID_URL
• 插件没装对版本：插件管理器里的同名插件是旧版，缺失 WebView2 支持；必须从 GitHub 官方发布页下载 MarkdownViewerPlusPlus-*.zip，解压后整个 MarkdownViewer++ 文件夹复制进 plugins 目录（不是只丢一个 DLL）

autoRefresh=0 是默认值，编辑后要等 1.5 秒才刷新

很多人以为“实时”是敲字即变，其实默认策略是“光标离开当前行 1.5 秒后才更新”。想改成真·所见即所得，得手动改配置：

• 打开 %APPDATA%\Notepad++\plugins\config\MarkdownViewer++.ini
• 找到 autoRefresh=0 这一行，改成 autoRefresh=1
• 重启 Notepad++ 或重载插件（Plugins → MarkdownViewer++ → Reload）
• 注意：开启后小文件无压力，但若文档超 5000 行，频繁重绘可能轻微卡顿——这不是 bug，是增量渲染的代价

最容易被忽略的是语言模式和路径限制：前者决定高亮有没有，后者决定预览出不出。很多人反复重装插件却卡在这两步，白白浪费半小时。