MarkdownViewerPlusPlus是Notepad++唯一稳定、持续维护且功能完整的原生Markdown预览插件;它基于Markdig引擎严格兼容CommonMark 0.28标准,支持表格、任务列表等语法,无需外部浏览器,具备实时双栏渲染、同步滚动及HTML/PDF导出能力。

Notepad++ 原生不支持 Markdown 预览,必须靠插件实现;目前唯一稳定、持续维护、功能完整且无需外部浏览器依赖的插件是 MarkdownViewerPlusPlus。
为什么不是 NppMarkdown 或其他旧插件
早期的 NppMarkdown 插件(如 2025 年资料中提到的)依赖老旧的解析器,不支持 CommonMark 标准,表格、任务列表、脚注等常见语法会渲染失败;它还强制调用系统默认浏览器进程,导致预览卡顿、样式丢失、无法同步滚动,甚至在无网络或离线环境下直接崩溃。而 MarkdownViewerPlusPlus 基于 Markdig 引擎,严格兼容 CommonMark 0.28,所有标准语法开箱即用。
安装后必须做的三件事
装完 MarkdownViewerPlusPlus.dll 并重启 Notepad++ 后,立刻检查以下配置项:
- 在
Plugins → MarkdownViewer++ → Options中,把File extensions改成md,markdown,txt(加txt是为了临时预览未加扩展名的草稿) - 勾选
Enable synchronized scrolling—— 否则长文档编辑时,光标和预览位置完全错位,校对效率归零 - 确认
Include new files?已启用,否则新建的.md文件不会自动触发预览面板
导出 PDF 时最容易踩的坑
MarkdownViewerPlusPlus 的 PDF 导出功能看似一键,但实际受两个隐藏因素影响:
- CSS 样式表路径必须为绝对路径,相对路径(如
./style.css)会被忽略,导出后格式全乱 - 若文档含本地图片(
),PDF 导出默认不嵌入,需手动勾选Embed images in PDF选项,否则生成的 PDF 显示空白占位符 - 页面边距单位固定为毫米(
mm),填20表示 20mm,填20px会静默失效
真正麻烦的不是装不上,而是装上后默认配置下,预览看起来“差不多”,但一到导出或处理复杂文档(比如带 Mermaid 图表、自定义 CSS、多级标题锚点跳转),就会暴露底层依赖和路径逻辑的硬约束——这些细节在插件 UI 里根本不提示,只能翻 GitHub issues 才能确认。


















