【开发者自荐】WP Editor.md 维护版,给停更 6 年的 WordPress Markdown 编辑器续命

软件名称

WP Editor.md 维护版

应用平台

  • WordPress 插件

  • 已在 WordPress 7.1 测试,兼容 PHP 7.4 – 8.4

  • 界面主要是给 PC 端设计的,手机端属于能用,但用着别扭。(大部分手机那个屏幕尺寸,用双栏编辑器肯定别扭)

推荐类型

【开发者自荐】

是否收费

免费,GPL-3.0-or-later 协议开源

一句简介

把经典的 Markdown 双栏编辑器带到 WordPress 后台,支持代码高亮、LaTeX 公式、Mermaid 图表、思维导图,截图粘贴上传等功能。

应用简介

起因很简单:我自己的博客用的就是这个插件。问题是 上游 2020 年 9 月发完 10.2.1 就停更了,2025 年 4 月又因为 CVE-2025-31035 被 WordPress 官方插件商店下架;插件停更了6年 WordPress 迭代到 7.x,PHP 也升到 8.4,原版插件还能用但小毛病一堆,偶尔还会直接把博客刷白屏。替代品我试了一圈都不好使,Markup Markdown 太简陋,文章直接以 Markdown 存库、插件哪天不可用前端就全炸;WP Githuber MD 被下架得比它还早。古腾堡支持 Markdown,但实际读写的还是 HTML ,而且那个 DOM 也写技术文章来说,也挺难用的。于是不如自己动手,趁十一假期从上游 Fork 了一份,一边用一边改,从 10.3.0 折腾到 10.5.4。

原版本身的底子就挺好用的:

  1. 双栏实时预览:左边写 Markdown 源码,右边实时渲染最终排版,滚动条同步联动。就经典的markdown编辑器的界面

  2. 技术博客的刚需全内置了:Prism.js 代码高亮(行号、语言标签、一键复制)、KaTeX 科学公式($…$ 就行)、Mermaid 流程图 / 时序图 / 甘特图、思维导图,不用为了这些再额外装三四个插件或外源脚本;

  3. 截图 Ctrl + V 直接上传:剪贴板里的图自动进媒体库并回填 Markdown 图片链接,省掉「保存到本地 → 打开媒体库 → 上传 → 插入文章」的操作。

  4. 不绑架底层数据:数据库里会同时保留 Markdown 原文和解析后的标准 HTML,哪天停用这个插件换回古腾堡或者其他编辑器,历史文章也照样正常显示,没有迁移的后顾之忧;

维护版主要修了这些:

  1. 修复存储型 XSS(就是让它被下架的那个 CVE-2025-31035):公式渲染的输出加了转义过滤,不然在文章或评论区塞一段构造好的恶意公式代码,一打开页面就被执行;

  2. 图片粘贴接口加固:原版对上传内容完全不设防,完全信任管理员的操作,不校验权限和来源、不检查文件到底是不是图片、不限制图片尺寸体积。现在按文件头验明正身、限制像素与内存预算、加上传频率限制,并改用 WordPress 官方接口写盘,防「图片炸弹」把服务器内存吃光或者遇到「伪装为图片的可执行文件」;

  3. 封掉 SSRF 与未登录接口:自带的图床接口不能再被外人当跳板探测内网,错误日志里会暴漏的安全令牌做了脱敏;

  4. 升级不安全的上古依赖:Mermaid 8.4.8 → 10.9.8 并锁最高安全级别、KaTeX 0.11.1 → 0.19.0 并关闭信任模式、前端 axios 升到 1.20.0;

  5. 默认本地加载资源,CDN 增加完整性校验:原版默认从第三方 CDN 拉脚本和样式,CDN 一被投毒自己网站就跟着遭殃。现在默认全部本地提供;想加速填外部 CDN 地址的话,10.5.1 新增了文件指纹校验,设置页点一下「用本机文件生成」算出哈希,给所有的外部资源文件添加 添加 integrity 属性。这样浏览器会校验文件哈希值,一旦文件被篡改,浏览器将拒绝加载。

  6. 适配 WordPress 7.1 与 PHP 7.4 – 8.4:修掉带特定 Cookie 就白屏、点卸载插件报语法错误、XML-RPC 发文章报错、后台思维导图开关被样式覆盖等一堆陈年 Bug;

  7. 解决后台访问卡顿问题:原版每开一个后台页面都会在背后同步请求一次外部服务器查资源版本,外网不通就硬卡 6 秒等超时,还会在每个页面顶部挂一条红色的「检验到插件资源包已过时」警告。现在阻塞式检查整个砍掉了,版本提示也只在对应设置页显示了;

  8. 修好 $ 符号误判:以前一篇文章里出现两个美元符号(比如「价格从 $100 涨到 200」),或者代码块里有带 `` 的变量,插件就把中间文字当数学公式强行渲染。重写了逻辑,编辑器预览和前台发布两套渲染也统一成一套;

  9. 修好双份代码高亮:原版居然会给同一页面加载了两套 Prism.js,互相抢着渲染;同时把 Mermaid 流程图刷不出来(内联脚本引号被 WordPress 过滤导致的)也一并修了;

  10. 移除已转收费的 sm.ms 图床(10.5.0):留着也是一堆失效配置和安全问题,干脆整个扬了,图片粘贴统一走本站媒体库;

  11. 增加了图片尺寸语法(10.4.0):![说明](图片地址 =600)、=600x400、=x400,图片地址和等号之间留一个空格,限制最大尺寸、小屏自动等比缩小,预览时同步生效;

  12. 评论区体验重做(10.5.0):新增可选的「访客评论简版编辑器」,工具栏只留 8 个真正能生效的按钮,移除了图片外链和可点击链接(防广告引流和钓鱼);顺手修了回复框自动激活、工具栏遮正文、窄屏自动换行、快速编辑能载入原文、回复不同评论自动清空上条草稿等一堆陈年bug;

截图预览

  • 经典双栏编辑器,左源码右预览

  • 语法高亮设置(行号、语言标签、一键复制)

  • 公式、流程图、思维导图

官方网站 / 源码

安装

  1. 在 Releases 下载 wp-editormd-x.y.z.zip。

  2. WordPress 后台进「插件 → 安装插件 → 上传插件」,选刚下的 zip 覆盖安装并启用;

  3. 升级前顺手备份一下数据库。我没动表结构,覆盖安装理论上碰不到数据,但动手前先备份这事儿永远没错。

PS:最后说句实话,它不是适合所有人的。纯图文随笔、一个月发一、两篇的,古腾堡其实也完全够用了,没必要折腾,天天贴代码、写长文档、本地又习惯用 Markdown 的,才轮得到它上场。在最新版 WordPress 或某些主题下遇到样式兼容问题,欢迎直接去仓库 Issues 反馈 或者在帖子下留言,去我博客里也行,我自己就在用,有问题肯定会修。

再PS:WordPress 虽然衰落了,但市占率还是挺高的,Markdown 目前也常用的,为啥 WordPress 就没一个好用的后台 Markdown 编辑器啊,除了我前边提到的那3个最知名的,基本上知道的后台编辑器都试过,可惜每个用起来感觉都会缺点啥,大家写长文时,总不能都是先本地写好,然后转 HTML 上传的吧。

1 个赞