notepad++需通过markdownviewer++插件实现markdown实时预览,该插件依赖系统webview、仅支持英文路径文件、不兼容mermaid/latex等扩展语法。

Notepad++ 本身不支持 Markdown 实时预览,插件 MarkdownViewer++ 是唯一稳定可用的方案
Notepad++ 没有内置 Markdown 渲染能力,官方插件仓库里长期只有 MarkdownViewer++ 能真正实现实时 HTML 预览(带语法高亮、表格、代码块等)。其他名字相似的插件(如 MarkdownViewer 或 PreviewHTML)要么已停止维护,要么仅能打开 HTML 文件,无法动态刷新。
安装前注意:MarkdownViewer++ 依赖系统级 WebView(Windows 10/11 自带,Windows 7 需额外装 Microsoft Edge WebView2 Runtime),否则启动预览会报错 Failed to create webview control。
- 推荐从 GitHub 官方发布页下载最新
MarkdownViewer++.zip(不是 Notepad++ 插件管理器里的旧版) - 解压后把
MarkdownViewer++文件夹整体复制到 Notepad++ 的plugins目录(路径类似C:\Program Files\Notepad++\plugins\) - 重启 Notepad++,菜单栏会出现
Plugins → MarkdownViewer++ → Preview in panel - 首次使用时右键编辑区 →
Language → Markdown,否则不会触发预览绑定
MarkdownViewer++ 预览面板不刷新?检查这三处硬性限制
它不是“所见即所得”编辑器,预览行为受文件状态和配置强约束:
- 文件必须已保存为
.md或.markdown后缀,未保存的临时文档无法预览 - 编辑器当前语言模式必须是
Markdown(菜单Language → Markdown),即使文件名正确但语言设为Text,预览面板空白且无提示 - 默认只在光标离开当前行 1.5 秒后自动刷新;若想改成交叉编辑实时刷新,需手动编辑配置:打开
%APPDATA%\Notepad++\plugins\config\MarkdownViewer++.ini,把autoRefresh=0改成autoRefresh=1
用 Ctrl+Alt+V 快捷键唤出预览,但别指望它支持 Mermaid 或数学公式
这个插件基于系统 WebView 渲染,所以能跑标准 CommonMark + GitHub Flavored Markdown,但扩展语法全部不生效:
文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。
-
```mermaid代码块 → 渲染为普通代码块,不画图 -
$E=mc^2$或$$...$$→ 原样显示,不解析 LaTeX - 自定义 CSS 或 JS 注入无效(WebView 沙箱限制)
- 如果需要这些功能,得换工具:VS Code +
Markdown All in One,或 Typora
中文路径或含空格的文件名会导致预览失败,这是 WebView 的已知缺陷
哪怕文件保存在 D:\我的笔记\readme.md,MarkdownViewer++ 也会因 URL 编码问题加载失败,控制台报 net::ERR_INVALID_URL。目前无补丁,只能绕过:
- 把工作目录移到纯英文路径下,例如
C:\md\ - 文件名避免空格和中文,用
readme_example.md替代我的第一个笔记.md - 若必须处理中文路径文件,建议仅用 Notepad++ 编辑,另开浏览器用
marktext或stackedit.io预览
插件作者在 issue 里明确回复过:这是底层 WebView 组件对非 ASCII 路径的兼容问题,Notepad++ 插件层无法修复。










