markdownviewer++ 是 notepad++ 唯一稳定、实时、深度集成的 markdown 预览插件,依赖 webview2、需正确安装 dll、要求文件已保存且语言设为 markdown,支持配置自动刷新,但不渲染 mermaid 和 latex。

MarkdownViewer++ 是目前 Notepad++ 唯一稳定、实时、可深度集成的 Markdown 预览方案。其他名字相近的插件(如 MarkdownViewer、PreviewHTML)要么已停更,要么只支持静态 HTML 文件打开,无法自动刷新。
安装失败?先确认系统 WebView 是否就绪
插件依赖 Windows 系统级 WebView2 控件,不是所有系统开箱即用:
- Windows 10/11 20H1 及更新版本自带 WebView2,通常没问题
- Windows 7 或旧版 Win10(如 1809 之前)必须手动安装 Microsoft Edge WebView2 Runtime
- 若预览面板空白或弹出
Failed to create webview control,就是这个原因 - 别试图用 Notepad++ 插件管理器装——它分发的是过时旧版,功能残缺且不兼容新版 Markdig 渲染引擎
DLL 文件放错位置会导致插件完全不加载
必须把 MarkdownViewerPlusPlus.dll 放进 Notepad++ 的 plugins 目录,而不是子文件夹里:
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
- 正确路径示例:
C:\Program Files\Notepad++\plugins\MarkdownViewerPlusPlus.dll - 错误做法:放进
plugins\MarkdownViewerPlusPlus\子目录(这是旧版插件结构,新版不认) - 如果 Notepad++ 安装在
AppData(便携版),路径类似:%APPDATA%\Notepad++\plugins\ - 复制后务必重启 Notepad++,否则菜单不会出现
Plugins → MarkdownViewer++
预览不显示?检查语言模式和文件保存状态
插件对触发条件非常严格,两个硬性前提缺一不可:
- 当前文档必须已保存为支持的扩展名(如
.md、.markdown、.spec),未保存的new 1文档永远不预览 - 编辑器语言模式必须设为
Markdown:右键编辑区 →Language → Markdown(即使文件名是readme.md,若语言设为Text,预览面板也为空白且无任何提示) - 默认刷新策略是“离开当前行 1.5 秒后”,想改成交互式实时刷新,需手动编辑配置文件:
%APPDATA%\Notepad++\plugins\config\MarkdownViewer++.ini,把autoRefresh=0改成autoRefresh=1
Mermaid / LaTeX 渲染失败?这不是 bug,是设计限制
MarkdownViewer++ 基于 Markdig + WebView2,只保证 CommonMark 0.28 和 GitHub Flavored Markdown 标准语法:
-
```mermaid代码块会被渲染为普通<pre class="brush:php;toolbar:false;"><code></code>,不执行绘图逻辑</pre> - 数学公式(
$...$或$$...$$)完全不解析,也不会报错 - 自定义 HTML 标签(如
<details></details>)能保留但不激活 JS 行为 - 如果你真需要 Mermaid,得换工具——
MarkdownViewer++的定位就是轻量、稳定、零干扰,不是全能型 Markdown IDE










