markdownviewer++ 是 notepad++ 唯一稳定可用的 markdown 实时预览插件,需手动从 github 官方发布页下载安装,因其支持 webview2、gfm 表格、任务列表等特性,而插件管理器版本陈旧且功能残缺;运行需同时满足已保存文件、扩展名正确、语言模式设为 markdown、路径无中文或特殊字符四前提,否则静默白屏。

MarkdownViewer++ 是当前 Notepad++ 唯一能稳定工作的 Markdown 实时预览方案;NppMarkdownPanel 在 v8.0+ 版本中会直接崩溃,错误信息是 Access violation at address in module 'npp.dll';MarkdownViewer(旧版)基于 IE7 内核,连代码块高亮都失效,中文路径下常报 net::ERR_FILE_NOT_FOUND。
为什么必须手动装 MarkdownViewer++,而不是用插件管理器?
插件管理器里同名的 MarkdownViewer++ 是多年未更新的阉割版,缺失 WebView2 支持、autoRefresh 控制和 GFM 表格渲染能力。官方发布页的 zip 包才含最新版——它依赖系统自带的 WebView2(Windows 10/11),能正确渲染任务列表(- [x])、GFM 表格、自动链接等。
- 下载地址必须是 GitHub 官方发布页(不是插件管理器里的同名项)
- 解压后要把整个
MarkdownViewer++文件夹复制进plugins目录,不是只丢一个 DLL - 路径示例:
C:\Program Files\Notepad++\plugins\MarkdownViewer++\
预览面板空白 的四个硬性前提缺一不可
这个插件不报错、不提示,只白屏——你得自己逐条核对:
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
- 文件必须已保存,且扩展名是
.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
别指望它支持这些功能
它走的是系统 WebView 沙箱,所有扩展能力被禁用:
-
Mermaid图表、LaTeX公式(如$E = mc^2$)、脚注、front matter 全部不解析 - 无法注入自定义 CSS,导出 HTML 也不带样式,只输出纯 HTML 结构
- 预览样式固定,没有暗色/亮色主题切换,也没有 AI 排版建议或 PDF 导出(部分教程提到的 PDF 功能在 2026 年 6 月最新版中仍未开放)
真正卡住人的从来不是安装步骤,而是那三个看似琐碎却强制执行的运行条件:已保存、路径干净、语言模式正确。漏掉任意一个,预览就静默失败——它不会弹窗,不会报错,只留一片空白。










