MarkdownViewer++是当前Notepad++唯一稳定可用的Markdown实时预览插件，需满足已保存文件、路径无中文/空格、语言模式设为Markdown三条件；基于WebView2渲染，支持GFM标准但不支持Mermaid、LaTeX等扩展。

Notepad++ 本身不支持 Markdown 实时预览，必须靠插件补足；目前唯一稳定、持续更新、且能真正实现“边写边看”的方案是 MarkdownViewer++，但它有硬性前提——文件已保存、路径无中文/空格、语言模式设为 Markdown，缺一不可。

为什么 MarkdownViewer++ 是当前唯一可行选择

旧插件如 NppMarkdownPanel 在 Notepad++ v8.0+ 下会触发 Access violation at address ... in module 'npp.dll' 直接崩溃；MarkdownViewer 基于 IE7 渲染内核，连代码块高亮都失效，中文路径下常报 net::ERR_FILE_NOT_FOUND。而 MarkdownViewer++ 基于系统 WebView2（Windows 10/11 自带），能正确渲染表格、代码块、GFM 表格、任务列表（- [x]）、自动链接等，且维护活跃。

它不是从插件管理器装——官方发布页的 zip 包才含最新版，插件管理器里的是多年未更新的阉割版。

安装与启动预览的三步硬操作

跳过所有“自动安装”幻想，按顺序执行：

Telegram Markdown Adapter

将 Markdown 格式的回复转换为适合 Telegram 的富文本，避免渲染错误。适用于用户偏好 Markdown 但目标平台为 Telegram 的场景。

下载

• 从 GitHub 官方发布页下载 MarkdownViewer++.zip（不是插件管理器里的同名项）
• 解压后把整个 MarkdownViewer++ 文件夹复制到 Notepad++ 的 plugins 目录（例如 C:\Program Files\Notepad++\plugins\）
• 重启 Notepad++，菜单栏出现 Plugins → MarkdownViewer++ → Preview in panel，或用快捷键 Ctrl+Alt+V

预览面板空白？先检查这四个死条件

这个插件对运行环境极其敏感，任一不满足都会白屏，且不报错：

• 文件必须已保存，且后缀为 .md 或 .markdown（未保存的临时文档不触发预览）
• 编辑器当前语言模式必须是 Markdown（右键编辑区 → Language → Markdown，仅靠文件名正确但语言设为 Text 会失败）
• 文件路径不能含中文、空格或特殊符号（例如 D:\我的笔记\readme.md 会因 URL 编码失败，控制台报 net::ERR_INVALID_URL）
• 默认刷新策略是“光标离开当前行 1.5 秒后”，若想编辑即刷新，需手动改配置：打开 %APPDATA%\Notepad++\plugins\config\MarkdownViewer++.ini，把 autoRefresh=0 改成 autoRefresh=1

别指望它支持 Mermaid、LaTeX 或自定义 CSS

MarkdownViewer++ 渲染走的是系统 WebView 沙箱，所有扩展能力被禁用：

• Mermaid 图表、数学公式（$E = mc^2$）、脚注、front matter 全部不解析
• 无法注入自定义 CSS，导出 HTML 时也不能带样式，只输出纯 HTML 结构
• 预览样式固定，暗色/亮色主题切换、AI 排版建议、PDF 导出等功能属于第三方魔改版，非官方 MarkdownViewer++ 所有

真正的实时预览代价是功能收敛——它只做一件事：用系统 WebView 快速、稳定、兼容地渲染标准 CommonMark + GFM，其他都是干扰项。路径、编码、语法扩展，三者中只要有一个越界，预览就静默失效，这是最容易被忽略的调试盲区。