Notepad++ Markdown 实时预览:MarkdownViewer++ 5 分钟快速上手
【免费下载链接】MarkdownViewerPlusPlusA Notepad++ Plugin to view a Markdown file rendered on-the-fly项目地址: https://gitcode.com/gh_mirrors/ma/MarkdownViewerPlusPlus
在 Notepad++ 里改完一段文字,不必存盘再切到浏览器,右侧停靠面板已经显示出渲染后的样子。这就是 MarkdownViewer++ 带来的 Notepad++ Markdown 实时预览:一个 Notepad++ 插件,把当前文档按 CommonMark 规则转成 HTML 显示在面板里,顺手还能把 Markdown 一键导出为 HTML 或 PDF。下面按装、用、配、排错的顺序讲一遍。
对比双窗口旧流程,先看清它能干什么
想在 Notepad++ 里预览 Markdown 的人,多半被旧流程磨过:编辑器里改文档,切到浏览器打开文件或网页工具,看完再切回来核对,标题层级改错一次就要来回几趟;换台机器或换个工具,渲染结果还不一样。把渲染挪进编辑器窗口后,差异大致如下:
| 能力 | 实际表现 |
|---|---|
| 实时渲染 | 编辑当前标签页,停靠面板同步刷新出 HTML 效果 |
| 扩展名过滤 | 只渲染你列出的扩展名,其余文件不触发 |
| 自定义 CSS | 一套样式同时作用于预览和导出的 HTML |
| 一键导出 | 面板工具栏把文档存成 .html 或 .pdf |
| 同步滚动 | 编辑器垂直滚动时,预览面板按比例跟随 |
✅ 装好插件,完成第一次预览
拿到可用的插件文件
MarkdownViewer++ 插件安装的核心动作只有一个:把MarkdownViewerPlusPlus.dll复制到 Notepad++ 安装目录的plugins(或plugins\new)文件夹,然后重启 Notepad++。想从源码构建时,先克隆仓库再编译,把生成的 dll 复制到同一位置:
git clone https://gitcode.com/gh_mirrors/ma/MarkdownViewerPlusPlus运行环境需要 Windows、.NET Framework 4.0 以上,Notepad++ 32 位或 64 位均可。
打开预览面板
打开任意 Markdown 文件,按Ctrl+Shift+M,或点工具栏上新出现的 Markdown 图标,预览面板会停靠到编辑器一侧;也可以走 插件 → MarkdownViewer++ 菜单。切换标签页时,面板自动换成当前文档的渲染结果。
左侧为 Markdown 源码,右侧为插件渲染出的实时预览面板。
确认默认识别范围
扩展名过滤默认关闭,也就是所有文本文件都会参与渲染。只想让.md、.txt这类文件参与时,在 General 选项卡填写扩展名即可;未被覆盖的文件打开后,面板会显示一条提示而不是渲染结果,属于正常行为。
选项面板逐项配置
从 插件 → MarkdownViewer++ → Options 打开设置,共三个选项卡。所有设置会写入 Notepad++ 的plugins\config\MarkdownViewerPlusPlus.ini,下次启动自动生效。
General
- 扩展名列表:逗号分隔、不带点号,如
md,txt,log;留空表示渲染全部文件,仅接受字母与逗号 - 包含新建文件:决定是否渲染尚未保存的 new N 文档
- 注意只比对扩展名,不看文件内容或 MIME 类型
HTML
- 自定义 CSS:同时作用于预览面板和导出的 HTML,上限 32767 字符
- 导出后自动打开:保存完 HTML 直接调起浏览器查看
- 方向与纸张:默认纵向、A4
- 四边边距:单位毫米,默认各 5
- 导出后自动打开:保存完直接打开生成的 PDF
General 管识别规则,HTML 管样式,PDF 管导出参数。
把预览嵌入两个日常工作流
工作流 A:技术文档协作
- General 里填
md,txt,让项目内的说明文档都参与渲染 - 写文档时盯住右侧面板,标题层级和列表缩进当场核对
- 要发给非技术人员前,在面板工具栏把内容导出为 PDF
- PDF 选项卡统一纸张和边距,团队拿到的版本观感一致
工作流 B:多平台排版
- 在 HTML 选项卡粘入目标平台的 CSS,调整字体和标题样式
- 把这套 CSS 复制进一个 .txt 文件留底,作为模板
- 正文只写一份,切换不同 CSS 后分别导出 HTML
- 各平台拿到的 HTML 观感统一,排版时间省下来
常用入口整理:
| 操作 | 方式 |
|---|---|
| 显示 / 隐藏预览面板 | Ctrl+Shift+M |
| 打开预览面板 | 工具栏 Markdown 图标 |
| 切换同步滚动 | 插件菜单 → Synchronize scrolling |
| 打开选项 | 插件菜单 → Options |
管理自定义样式与扩展识别
留几套 CSS 模板
自定义 CSS 只有一个输入框,切换模板靠手。建议把博客版、打印版、深色版各存一份文本文件,要换时整段粘贴覆盖。这套 CSS 同时影响预览和导出,改完先看一眼预览再导出。
按内容类型放宽扩展名
扩展名比对不区分大小写,但只看后缀。习惯用.note记笔记、用.log存日志的话,把后缀加进列表即可;留空则所有文件都渲染。
开启同步滚动
菜单里的 Synchronize scrolling (Editor -> Viewer) 让预览面板跟随编辑器垂直滚动,方向是单向的:编辑器带动预览,反过来不会。勾选状态会被记住,下次启动仍是开启。
⚠️ 按现象排查常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 插件菜单里没有 MarkdownViewer++ | dll 没放进 plugins 目录,或放完没重启 | 复制到plugins或plugins\new后重启 Notepad++ |
| 面板显示"配置未包含当前扩展名"提示 | 当前文件后缀不在 General 列表里 | 补上该扩展名,或清空列表渲染全部 |
| 中文显示成系统默认字体 | CSS 没有指定中文字体 | 在 HTML 选项卡加字体声明,见下方片段 |
| 导出 PDF 的页边留白不合预期 | 用的是默认 A4 纵向、5 毫米边距 | 在 PDF 选项卡调整纸张、方向与四边边距 |
中文字体示例(粘贴到 HTML 选项卡):
body { font-family: "Microsoft YaHei", sans-serif; }📎 查阅核心源码与配置路径
MarkdownViewerPlusPlus/MarkdownViewer.cs:菜单注册、渲染触发与滚动同步的主逻辑MarkdownViewerPlusPlus/MarkdownViewerConfiguration.cs:配置读写与默认值MarkdownViewerPlusPlus/Forms/AbstractRenderer.cs:预览面板与 HTML/PDF 导出实现MarkdownViewerPlusPlus/Resources/MarkdownViewerHTML.css:内置默认样式- 运行期配置:Notepad++ 目录下的
plugins\config\MarkdownViewerPlusPlus.ini
从复制 DLL 到调好扩展名和样式,整个过程不超过五分钟。装完不必急着折腾别的,挑一份手头正在写的 Markdown 文档,按Ctrl+Shift+M把预览面板叫出来用起来。
【免费下载链接】MarkdownViewerPlusPlusA Notepad++ Plugin to view a Markdown file rendered on-the-fly项目地址: https://gitcode.com/gh_mirrors/ma/MarkdownViewerPlusPlus
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考