Notepad++ Markdown 实时预览:MarkdownViewer++ 5 分钟快速上手
2026/9/23 7:18:46 网站建设 项目流程

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 直接调起浏览器查看

PDF

  • 方向与纸张:默认纵向、A4
  • 四边边距:单位毫米,默认各 5
  • 导出后自动打开:保存完直接打开生成的 PDF

General 管识别规则,HTML 管样式,PDF 管导出参数。

把预览嵌入两个日常工作流

工作流 A:技术文档协作

  1. General 里填md,txt,让项目内的说明文档都参与渲染
  2. 写文档时盯住右侧面板,标题层级和列表缩进当场核对
  3. 要发给非技术人员前,在面板工具栏把内容导出为 PDF
  4. PDF 选项卡统一纸张和边距,团队拿到的版本观感一致

工作流 B:多平台排版

  1. 在 HTML 选项卡粘入目标平台的 CSS,调整字体和标题样式
  2. 把这套 CSS 复制进一个 .txt 文件留底,作为模板
  3. 正文只写一份,切换不同 CSS 后分别导出 HTML
  4. 各平台拿到的 HTML 观感统一,排版时间省下来

常用入口整理:

操作方式
显示 / 隐藏预览面板Ctrl+Shift+M
打开预览面板工具栏 Markdown 图标
切换同步滚动插件菜单 → Synchronize scrolling
打开选项插件菜单 → Options

管理自定义样式与扩展识别

留几套 CSS 模板

自定义 CSS 只有一个输入框,切换模板靠手。建议把博客版、打印版、深色版各存一份文本文件,要换时整段粘贴覆盖。这套 CSS 同时影响预览和导出,改完先看一眼预览再导出。

按内容类型放宽扩展名

扩展名比对不区分大小写,但只看后缀。习惯用.note记笔记、用.log存日志的话,把后缀加进列表即可;留空则所有文件都渲染。

开启同步滚动

菜单里的 Synchronize scrolling (Editor -> Viewer) 让预览面板跟随编辑器垂直滚动,方向是单向的:编辑器带动预览,反过来不会。勾选状态会被记住,下次启动仍是开启。

⚠️ 按现象排查常见问题

现象原因处理
插件菜单里没有 MarkdownViewer++dll 没放进 plugins 目录,或放完没重启复制到pluginsplugins\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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询