Notepad++唯一稳定可用的Markdown实时预览方案是MarkdownViewer++;它基于WebView2和Markdig,支持GFM表格、任务列表等,但不支持Mermaid/LaTeX,且须满足已保存.md文件、语言设为Markdown、路径无中文空格、配置autoRefresh=1四前提。

Notepad++ 本身不支持 Markdown 实时渲染,必须依赖插件;目前唯一稳定、持续更新、且能在 v8.0+ 版本上正常工作的方案是 MarkdownViewer++,但它有四个硬性前提,缺一不可——否则预览面板必然空白,且不报错。
为什么 MarkdownViewer++ 是当前唯一可行选择
旧插件如 NppMarkdown 在 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])、自动链接、代码块等,且维护活跃。
注意:Plugin Manager 里搜到的同名插件是多年未更新的阉割版,必须从 GitHub 官方发布页下载最新 zip 包(如 MarkdownViewerPlusPlus-0.8.2-x64.zip)。
MarkdownViewer++ 预览空白?先检查这四个死条件
插件对运行环境极其敏感,任一不满足都会白屏:
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索,适用于需要快速、高效搜索大量 Markdown 文章的场景。
- 文件必须已保存,且后缀为
.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
导出 HTML / PDF 时要注意什么
MarkdownViewer++ 导出功能可用,但能力受限:
- 导出 HTML 保留所有渲染结构,但不带样式(无法注入自定义 CSS,导出结果是纯 HTML 标签)
- 导出 PDF 依赖系统打印驱动,页面方向、边距可调,但数学公式(
$E = mc^2$)、Mermaid 图表、front matter、脚注全部不解析 - 导出内容与预览效果一致——前提是预览本身已成功加载;若预览为空白,导出也是空 HTML 或空白 PDF
真正卡住人的从来不是安装步骤,而是那四个“不报错却静默失败”的前提条件。尤其是路径含中文和语言模式未切换这两项,90% 的白屏问题都出在这儿。










