★ FEATURED ARTICLE 简介面向需要在Notepad中编写Markdown文档的开发者和IT从业者这款资源提供了一套轻量且可扩展的Markdown编辑增强方案特别适合日常技术写作、项目README维护和博客素材整理。压缩包共含2个文件分别是dll插件核心与xml语法高亮配置整体大小约228KB安装后即可为Notepad增加Markdown解析、实时预览及Zenburn暗色主题下的语法高亮功能。已有1827人学习下载对于习惯使用Notepad的用户无需更换编辑器便能获得类似专业Markdown工具的体验。dll文件负责文档解析与预览调用xml配置则针对标题、列表、代码块、引用等元素提供高对比度着色暗色背景可降低长时间盯屏造成的视觉疲劳同时保留Notepad轻便启动、自定义规则灵活的优势让作者在编辑过程中即时核对排版效果显著提升文档编写与校对效率。1. Notepad MarkDown插件及预览这是我出差时唯一还愿意打开的手写文档工具别急着笑我知道一提到 Notepad 很多人第一反应是“古老”“过时”。但真当你坐在一台只有 4G 内存、开着远程桌面的老办公电脑前或者临时要给另一台机器上的 Markdown 文件改两行说明文字时你会发现那些几百 MB 起步的现代编辑器反而成了负担启动慢、弹更新、还要配工作区。这个时候“装个 Notepad MarkDown 插件写完直接预览”才是真正能让心思回到内容上来的方案。这篇文章就沿着这个标题往下拆为什么插件值得装、插件和预览是怎么配合的、三步怎么落地、以及我踩过的坑。读者如果是经常写 README、技术博客或接口文档的开发者这篇笔记会让你把 Notepad 重新捡回来当“第二只手”而不是放在那积灰。2. 原理与选型为什么 Notepad 处理 MarkDown 仍然舒服装插件前先搞清三件事2.1 插件加载机制Notepad 的插件本质上是 DLL不是“功能开关”在动手下载插件之前我建议先花五分钟理解 Notepad 的插件目录结构。Notepad 的插件体系很古老但非常透明它会在安装目录下找plugins子目录把里面符合接口规范的 DLL 文件加载进来再读取配置目录里的快捷键和设置。这里的配置目录有一个很容易踩的坑就是你用安装包安装时配置存在%APPDATA%\Notepad而如果你用的是 zip 绿色版配置大概率落在程序目录自带的config.xml里。两种模式对插件是否生效影响很大我在一台公司电脑上用绿色版装了 MarkdownViewer插件菜单死活出不来最后发现绿色版根目录下根本没有plugins文件夹而我是把 DLL 放到了系统盘的 AppData 里程序根本没认。所以动手前先确认一件事你的 Notepad 是安装版还是绿色版。打开“插件”菜单看有没有Open Plugin Folder不同版本翻译不一样有的叫“打开插件文件夹”。如果有直接点它弹出的资源管理器路径就是当前程序的插件目录。如果连这个菜单都没有说明插件系统本身有问题常见原因是你用了精简版或某些修改版这种版本我建议直接换官方 zip 绿色版因为官方绿色版反而保留了完整的插件加载逻辑。版本类型插件路径配置路径适合谁安装版C:\Program Files\Notepad\plugins%APPDATA%\Notepad日常主力写作zip 绿色版解压目录\plugins解压目录相对路径出差、U盘便携2.2 MarkDown 是语法插件管的是“编辑体验”别指望 Notepad 帮你渲染很多人把“MarkDown 插件”和“MarkDown 编辑器”混为一谈。这里我要把边界划清楚Notepad 本体是纯文本编辑器它对 Markdown 的处理只停留在“把# 一级标题染成橙色、把**加粗**染成黄色”这一步这就是语法高亮。预览功能是另外的插件干的它负责调用浏览器内核把渲染后的 HTML 展示出来两者是两套代码。理解这个分层对排查问题很有用。如果你打开.md文件发现一片白那不是文件坏了而是 Notepad 还没把它识别成 Markdown。在“语言”菜单里找到 “Markdown” 并点击语法高亮就会立刻生效。如果连菜单里都没有 “Markdown” 选项那就说明你的版本太老需要先升级或者手动复制一个markdown.xml语言定义文件到language目录。顺带一提Mac 用户羡慕的 Sublime Text 有一个叫 “MarkdownEditing” 的插件功能确实华丽但 Notepad 加一个语法高亮插件后的效果已经足够日用了标题、列表、引用块、行内代码全部一眼可辨。2.3 选型预览插件只有稳定的才是好用的我长期保留的是这两个现在网上能找到的 Notepad Markdown 预览插件并不多常见名字有MarkdownViewer、NppMarkdown、MarkDownPanel。我自己的血泪经验是别为了追求新功能去选界面花哨的写作场景下稳定性压倒一切。我长期使用的组合是MarkdownViewer负责预览外加系统里装一个pandoc做导出后者到第四章再说。为什么首选 MarkdownViewer因为它自带了一个独立窗口按一下快捷键就能在编辑区旁边弹出渲染结果而且它用的是内嵌 IE 内核不需要你额外装浏览器组件老电脑也不容易卡。NppMarkdown 的问题在于它给出的预览是一个纯 HTML 文件你要手动在浏览器里打开来回切换烦得不行。如果你在热词里搜到markdown 数学公式插件注意 MarkdownViewer 对 LaTeX 公式的支持比较弱需要配合MathJax才能渲染这个我会在第四章给一个折中方案。3. 二步装好 Notepad MarkDown 插件插件管理器自动装和手动拷贝都怎么操作3.1 方法 A从插件管理器直接安装但要注意管理员权限这个坑从 Notepad 7.6 之后官方就自带了Plugin Manager部分版本显示为插件管理。操作路径是顶部菜单“插件” - “插件管理” - 勾选MarkdownViewer- 点击“安装” - 重启 Notepad。整个过程不需要访问任何外部网站非常省心适合新手。但这里有一个必踩的坑如果你的 Notepad 是以管理员身份运行的比如你勾选了“以管理员身份运行此程序”而插件管理器启动时没有获得同样的权限它去写入 Program Files 目录时会被系统拦截结果就是安装进度条走完了插件却始终不在菜单里。我们公司很多同事的电脑就是这种情况一开始以为插件坏了实际上是 Windows 用户账户控制弹窗被忽略了。解决方式也很简单右键 Notepad 图标选“以管理员身份运行”再装一次插件。装完后关掉正常双击打开使用即可。插件安装好之后再没必要天天用管理员权限启动否则反而会导致你的配置文件被改到另一个用户目录下这是后话。3.2 方法 B手动拷贝 DLL绿色版和离线环境的唯一解有些机器出于安全策略不允许安装插件管理器或者你的 Notepad 是绿色版、插件管理按钮是灰的。这时手动拷贝就成了唯一解。这里需要你去官方插件仓库Github 上对应的 Releases 页下载MarkdownViewer的压缩包里面通常是一个 DLL 文件和几个说明文档。把 DLL 拷贝到 Notepad 的plugins文件夹后重启程序。如果菜单里没出现请立刻检查两个地方第一DLL 文件名是否保留了原来的名字我见过有人把 DLL 改名成markdown.dll后插件直接无法加载因为插件内部会按原名查找资源第二DLL 是否被 Windows 标记为“来自其他计算机”右键查看属性如果有“解除锁定”按钮就点一下。这一步做完百分之九十九的加载失败都能修复。# 假设你已经下载了 MarkdownViewer 的压缩包下面是典型的绿色版部署流程 cd /d 你的解压目录 mkdir plugins copy /Y %USERPROFILE%\Downloads\MarkdownViewer.dll .\plugins\ # 复制完成后启动 notepad.exe检查插件菜单这段命令背后的逻辑就三行先保证插件目录存在再把压缩包里的主 DLL 放进去最后用启动程序的动作触发插件加载。注意copy的时候不要顺手把压缩包里其他资源文件也一股脑塞进去MarkdownViewer 只需要 DLL 即可其他文件是源码或说明留待你需要自定义时再读。3.3 最小可行性验证三秒确认插件已经加载成功安装完插件后不要直接就开始写先做一个三秒验证打开任意一个.md文件按快捷键Ctrl Shift V。如果右侧或独立窗口弹出渲染结果说明插件不仅加载成功而且快捷键已经被默认绑定。如果没有反应打开“插件”菜单看有没有“MarkdownViewer”子菜单再点一下“Preview”看有没有窗口出现。这里有个容易忽略的参数说明Notepad 的快捷键是可以自定义的。如果你曾经装过其他插件占用了Ctrl Shift V预览窗口就不会唤醒。此时到“设置”-“管理快捷键”-“插件命令”里手动给 MarkdownViewer 的 Preview 命令分配一个唯一键位我用的是Alt M因为手指移位距离短且几乎不会和其他编辑器冲突。4. 预览也能调好三种预览方式对比以及我认为必调的三个参数4.1 内置窗口预览 vs 浏览器预览 vs 导出 HTML各自适合什么场景预览方式操作成本实时性适合场景MarkdownViewer 内置窗口快捷键调出高滚动同步写作时的常规检查浏览器打开 HTML用自定义命令导出需要一条命令或脚本低需手动刷新需要复制渲染结果给人看安装 python 脚本插件实现自动导出一次性配置中保存后自动批量产出、文档维护我一般是这样分配的写博客或接口说明时用内置窗口因为草稿阶段的渲染只是为了发现自己有没有写错语法不用多精致等到最终交给别人审阅时我会用第四章后面的命令把 HTML 导出来发文件而不是发源码。另外如果你搜索过markdown 换行和markdown 插入code这两个热词就知道很多渲染不一致的问题其实是 Markdown 方言差异导致的换成导出的 HTML 后至少能让对方看到的和你一致。4.2 MarkdownViewer 必调的三处设置第一个必调参数是“自动刷新”。MarkdownViewer 默认设置下每次编辑后需要手动点一下刷新按钮才能看到最新效果这对写作很打断思路。打开插件的设置窗口勾选Auto Reload选项。注意这个选项有时会被翻译成“自动重载”它靠的是文件变化触发如果你用的是其他插件做了“行尾自动保存”也能配合得很好我在设置里开了“在失焦时保存”从来没有遇到过刷新丢内容的情况。第二个必调参数是“自定义 CSS”。插件默认的渲染样式是白底黑字看久了刺眼而且代码块的背景灰得很廉价。MarkdownViewer 的设置里允许你指定一个本地 CSS 文件我会把 GitHub 风格的 CSS 下载下来放本地再把路径填进去。理论上你甚至可以用深色主题但我的建议是预览样式尽量贴近最终发布平台的样式比如公众号文章就别用窄宽度直接调整合适的阅读宽度。第三个参数是“HTML 模板”。这个参数很多人从来不碰但它决定了导出的 HTML 是否完整默认模板生成的 HTML 是碎片化的不包含html和head标签如果你的用法跟我一样是把预览窗口里的 HTML 复制去发邮件就会遇到样式丢失。打开设置把模板替换成下面这份精简版!DOCTYPE html html head meta charsetutf-8 titleMarkdown 导出/title link relstylesheet href你的本地CSS路径.css /head body !-- 这里放 Markdown 渲染结果 -- /body /html参数说明charset必须声明为utf-8否则导出文件放到别人电脑上会出现中文乱码link标签里的 CSS 路径可以写相对路径也可以写网络 CDN 链接我一般写本地绝对路径这样断网也能渲染。4.3 一键导出 HTML用 NppExec 加命令行工具把最后一个预览缺口补上想在浏览器里看渲染结果用内置窗口的“Save to HTML”也行但生成的临时文件藏得深找起来麻烦。我的做法是用 NppExec 插件绑定一条命令按下F6就把当前文件转成 HTML 并自动打开。前提是你先安装了pandoc并加进了系统 PATH这一步在 Windows 下的安装方式请自行去官网下载安装包NppExec 的命令如下# 将当前打开的 .md 文件导出为同名 .html 并在默认浏览器打开 pandoc $(FULL_CURRENT_PATH) -s -o $(CURRENT_DIRECTORY)\$(NAME_PART).html cmd /c start $(CURRENT_DIRECTORY)\$(NAME_PART).html那段宏命令的解释$(FULL_CURRENT_PATH)是 NppExec 提供的变量代表当前完文件路径带引号是为了兼容路径中含空格的情况这是 Windows 下最常踩的坑-s让 pandoc 生成独立 HTML含头尾结构start 是 Windows 下后台打开文件的标准写法。装上这个命令后我写 Markdown 的流程就是Notepad 编辑Alt M看同步预览最后F6一键出成品整个过程不需要离开键盘。5. Notepad MarkDown 插件避坑指南五条血泪经验照着排查省一下午5.1 预览窗口空白但语法高亮正常现象语法高亮一切正常标题、加粗都显示颜色但Ctrl Shift V弹出来的预览窗口一片白。原因最常见的是 MarkdownViewer 内置的渲染引擎依靠 IE 组件而 Windows 10/11 上 IE 被默认禁用或降级为兼容模式。另一个可能原因是你正在编辑的文件没有保存成.md后缀插件识别不到内容类型渲染器拿不到有效输入。解决先看文件后缀确实不是.md的另存为 .md确保后缀没问题后在预览窗口的设置里把渲染引擎从 IE 切换成 WebView2如果你的插件版本支持。如果两个办法都没用去插件选项里点“Reset Default”有时候设置面板里的模板被我改坏了重置就好了。5.2 浏览器打开导出的 HTML提示“你尝试预览的文件可能对你的计算机有害”现象我用 F6 导出 HTML 后双击打开浏览器顶部弹黄色/红色警告条需要手动点“保留”才能看。原因这是 Windows 的“Mark of the Web”机制在起作用。任何从网上下载的文件包括 pandoc 生成的 HTML都被打上了Zone.Identifier标记浏览器会询问你是否信任。我最早以为是 pandoc 生成的 HTML 有问题排查半天才发现是文件从下载目录复制出来后依然保留着这个属性。解决右键 HTML 文件 - 属性 - 勾选“解除锁定”。如果想彻底不弹可以在文件管理器中选中所有导出的 HTML批量解除锁定。注意这个警告与“markdown 文件怎么打开”完全无关别因此怀疑插件坏了。5.3 插件菜单里根本没有“MarkdownViewer”这一项现象我已经确认 DLL 放进了 plugins 目录甚至在“插件”菜单里能看到其他插件但找不到 MarkdownViewer。原因大概率是 DLL 和 Notepad 的位数不匹配。Notepad 的插件必须与其架构一致32 位程序认 32 位 DLL64 位程序认 64 位 DLL。下载插件时没有注意架构拷贝进去后程序会静默忽略。解决在 Notepad 的“帮助”里查看“关于”确认是 32 位还是 64 位再去官方 Releases 下载对应版本。这个排查顺序要优先于检查路径问题因为 DLL 不存在会有报错DLL 不匹配反而没有任何提示。5.4 预览和编辑器里看到的图片路径不一致现象在预览窗口里图片全部裂开但用 VS Code 或其他编辑器打开同一份 Markdown 文件图片能正常显示。我的图片是放在和文档同级的images文件夹里引用路径写的是images/foo.png。原因MarkdownViewer 的预览窗口是以临时 HTML 文件的位置为基准来解析图片路径的它跑在临时目录里自然就找不到相对路径的图片。这属于插件实现的边界问题不是你的语法写错了。解决不想换编辑器的话有两个办法。第一个是在图片引用时使用绝对路径但这样换电脑就失效第二个是写一个小的 python 脚本在预览之前把相对路径替换成完整路径。我在第六章会给出这段脚本这里你先记住预览窗口里的图片渲染本来就是“可能翻车”的黑匣子不值得为了它在编辑器里较劲。5.5 表格渲染错乱尤其是从 Excel 复制过来的数据现象我从 Excel 复制了一段数据粘贴到 Markdown 表格里预览时发现行列全乱了有些单元格粘在一起。原因Excel 复制的数据是制表符分隔的而 Markdown 表格要求|作为列分隔符且表头和分隔行不能省略。只靠 Notepad 的插件不会帮你转换格式它只负责把已写好的表格语法原样渲染。解决粘贴到 Notepad 后先全选表格区域把所有制表符替换成|的格式手动补上表头分隔行| --- | --- |。如果你经常要转换搜索 “markdown表格转换excel” 能找到在线工具但出于安全考虑不建议把内部数据贴到在线工具里去。我的习惯是保留一个 python 小工具在本地用 pandas 读 Excel、输出 Markdown 表格几行代码一劳永逸。值得注意的是 Markdown 表格里的换行处理也和普通段落不同一行就是一行别硬塞br预览会很难看。6. 再用 Python Script 把插件能力连起来自动预处理图片路径与批量导出走到这里插件安装和预览已经能覆盖你 90% 的日常了最后一步是打通“写文档到交付”的自动化。Notepad 有一个老牌插件叫Python Script它能把 Python 脚本注册成菜单命令用系统 Python 环境执行。我用它做了一个很实际的联动保存 Markdown 文件时自动把相对图片路径替换成当前文件的绝对路径让预览窗口里的图片永不裂开。# 导入 Notepad 的编辑器对象 import notepad import editor # 获取当前文件完整路径如果没保存过就停止 current_path notepad.getCurrentFilename() if not current_path: notepad.messageBox(请先保存文件, 提示) # 读取全文将相对路径 images/ 替换为绝对路径 text editor.getText() import os, re base os.path.dirname(current_path) text_new re.sub(r(!\[[^\]]*\]\()images/, r\g1 base.replace(\\, /) /images/, text) # 只在有变动时写回避免无意义回写 if text_new ! text: editor.setText(text_new) notepad.save()使用前打开 Python Script 插件把这段代码保存成一个脚本再在“插件”菜单的 Python Script 里配置好快捷键。它做的事情说白了就是三个判断文件有没有保存、用正则把images/前缀替换成完整路径/images/、写回并保存。replace(\\, /)这一行是在处理 Windows 路径分隔符换到 Linux 编辑器就不需要。参数说明就一条正则里的\g1引用的是图片的
