Xmao Markdown Paste正式版来啦！
Xmao Markdown Paste 插件介绍与测试完成公告（插件包在文章底部）
在使用 WordPress 发布技术文章、教程文档或开发笔记时，很多内容往往已经通过 Markdown 编写完成，但复制到前端编辑器后，标题、列表、引用、代码块和表格等结构经常需要重新排版。为了减少这些重复操作，我开发了 Xmao Markdown Paste。这是一款专为 WordPress Zibll 主题前端编辑场景设计的 Markdown 自动排版插件，目标是让已经写好的 Markdown 内容能够更自然、更高效地进入网站编辑流程。
目前插件最新版本为 v1.2.8
插件主要功能
Xmao Markdown Paste 会在适合的前端编辑区域识别粘贴操作。当粘贴内容符合 Markdown 特征时，插件会在浏览器端完成解析和转换，将 Markdown 结构转换为编辑器能够使用的 HTML 内容，从而减少再次设置格式的时间。
目前支持的常用内容包括：
- 多级标题、普通段落及换行；
- 有序列表、无序列表和引用内容；
- 加粗、斜体、删除线及超链接；
- 行内代码和多行代码块；
- Markdown 表格等常见排版结构；
- Zibll 桌面端、移动端及多种前端编辑场景；
- 图片粘贴放行，尽可能避免影响编辑器原有的图片上传行为。
插件并不会盲目覆盖所有粘贴内容。当解析失败、内容不符合预期或当前编辑区域不适合转换时，会尽量保留原始粘贴结果，降低内容丢失和错误替换的风险。整个 Markdown 转换过程主要在访问者或编辑者的浏览器中完成，不需要把正在编辑的文章内容提交到外部转换服务。
远程更新与公告
除 Markdown 自动排版外，插件已经内置独立的远程更新能力。安装后，WordPress 会通过定时任务自动检查可用版本，管理员也可以在插件页面点击“立即检查更新”手动刷新。检测到更高版本时，更新信息会进入 WordPress 原生更新流程，不需要用户自行填写更新接口。
插件页面只展示服务器连接状态、当前版本、远端版本以及版本更新历史，不会向普通管理员暴露不必要的接口配置。历史记录从 v1.0.0 首次发布开始保留，方便用户查看每个版本的主要变化。如果站点管理员进行了本地授权，并且发布版本允许自动安装，还可以使用 WordPress 的自动更新机制完成升级；未开启授权的站点仍然可以正常看到更新提示并手动安装。
管理员公告与版本更新相互独立。后续如有重要兼容性说明、维护通知或升级提醒，可以直接显示在 WordPress 管理后台，同时支持按插件版本和有效时间控制显示范围。远程公告仅用于传递纯文本通知，不能通过公告执行 PHP、JavaScript 或其他 WordPress 操作。
当前测试情况
截至 v1.2.8，插件已经完成本轮功能测试和发布流程检查。测试内容包括常用 Markdown 格式转换、代码块与表格处理、图片粘贴兼容、转换异常回退、插件启用与停用、后台信息页面、版本历史展示、服务器连接状态、自动与手动更新检测、远程公告显示、安装包结构检查以及同版本安装包重新发布等主要流程。
当前测试结果表明，插件核心功能运行正常，Markdown 粘贴、后台管理和远程更新功能可以按预期工作。发布安装包中的自有 JavaScript 已进行混淆处理，同时保留构建前的可维护源码，便于后续继续修复和升级。远程安装包在发布时会进行结构检查并计算 SHA-256，用于降低安装包被意外替换或下载内容不一致的风险。
需要说明的是，WordPress 的实际运行环境可能受到主题版本、PHP 版本、缓存插件、安全插件和浏览器差异影响。虽然当前版本已经完成既定测试，但建议生产站点在首次安装或升级前备份网站，并优先在测试环境验证与现有插件组合的兼容性。如果遇到问题，可以记录 WordPress 版本、Zibll 主题版本、浏览器版本及复现步骤，以便后续定位。
安装和使用方法
- 在 WordPress 后台进入“插件”页面，选择“安装插件”并上传 Xmao Markdown Paste 的 ZIP 安装包。
- 安装完成后启用插件，无需手动填写远程更新地址。
- 打开 Zibll 前端编辑页面，将准备好的 Markdown 内容粘贴到支持的编辑区域。
- 检查自动转换后的排版，根据文章实际效果进行少量调整并发布。
- 如需查看连接状态、版本历史或手动检查更新，可进入 WordPress 后台的“Xmao 插件”页面。
后续计划
后续版本将继续围绕编辑兼容性、Markdown 转换准确度、异常回退和使用体验进行优化，同时保持远程更新及历史记录的稳定性。插件不会为了增加功能而改变 WordPress 的核心编辑逻辑，也不会通过远程公告下发可执行代码。
Xmao Markdown Paste 希望解决的并不是“替代编辑器”，而是让 Markdown 内容进入 WordPress 的过程更简单。对于经常发布教程、代码示例、产品文档或技术文章的用户，它可以有效减少重复排版，把更多时间留给内容本身。
插件官网：https://www.sitn.top
赞助作者：https://www.sitn.top/sponsor/