一款为 Z-BlogPHP 深度定制的 Markdown 编辑器插件，基于开源内核 ByteMD 打磨而成，专为中文内容创作者设计。左右分栏实时预览、GFM 语法全覆盖、图片拖拽直传、双轨存储兼容全部主题——把富文本编辑器的格式噩梦，一次性交给插件处理。
谁需要这款插件
如果你是技术博客站长，经常要贴代码、做参数对比表格、写带删除线的修改稿；如果你厌倦了从 Word 粘贴文字后清理几十行内联样式；如果你希望编辑时的预览效果和发布后前台展示完全一致，而不是发布后才发现格式错乱——那么这款插件正是为你准备的。它同样适合非技术背景但希望用更清爽方式写作的中文博主：单次回车即换行，图片拖进来就能上传，不用记任何复杂语法。
它能为你解决什么
富文本编辑器最大的问题是"所见即所得"背后的脏数据。复制粘贴带入的内联样式、跨主题失效的排版、被二次着色搞乱的代码块，每一项都在消耗写作者的耐心。这款插件用 Markdown 的纯文本结构从根源上杜绝了格式污染：你写下的每一个字符都是干净、可读、可迁移的源码，发布后的 HTML 由统一引擎生成，无论切换什么主题都能稳定渲染。
代码高亮方面踩过的坑也已为你填平。插件在后台编辑器内提供完整的 highlight.js 预览，但前台不再注入任何高亮资源，彻底避免与主题自带方案冲突导致的双着重色、白屏等问题。后台解耦前台，兼容性由插件兜底。
核心功能一览
- 左右分栏实时预览：左侧 Markdown 源码、右侧 HTML 渲染，毫秒级双向同步，段落级同步滚动，长文写作不迷失
- GFM 语法全面支持：删除线、对齐表格、任务清单、自动链接，覆盖日常写作高频需求
- 代码高亮集成：内置 highlight.js，支持 C、Java、Python、Go、Rust、PHP、SQL 等数十种语言，预览即所见
- 中文工具栏深度定制：粗体、斜体、引用、链接、代码、列表、分割线、图片等按钮全面汉化，标题精简为一级至四级
- 软换行机制：单次回车即生成换行，HTML 输出按行独立包裹段落标签，符合中文写作直觉
- 图片拖拽直传：点击选择或拖拽本地图片到编辑区，自动对接 Z-Blog 附件系统，自动插入图片语法
- 双轨存储设计：同时保存 Markdown 原文与渲染 HTML，可编辑性与主题兼容性兼得，新旧文章无缝过渡
- 正文与摘要双输入框：正文和摘要均被 Markdown 编辑器接管，摘要同样享受 Markdown 写作便利
- 移动端响应式适配：小屏自动隐藏工具栏，把屏幕空间完整留给正文
- 安装即用：标准 Z-BlogPHP 插件流程，启用后无需任何配置
技术架构与设计亮点
插件以基于 Svelte 构建的 ByteMD 作为底层内核，体积极小、渲染迅速、扩展灵活。在此基础上进行了大量针对 Z-Blog 与中文场景的深度定制，而非简单套壳。
存储双轨制是这款插件在设计阶段思考最久的一环。编辑器在后台维护两个不可见 textarea：一个保存 Markdown 原文作为文章元数据，另一个保存渲染后的 HTML 写入原生内容字段。提交时插件拦截表单事件自动完成转换，前台读取的仍是标准文章字段，任何主题都无需改造。再次编辑时优先读取 Markdown 原文，旧文章无元数据则回退读取 Content 字段，新旧内容无缝衔接。
软换行则是为中文作者专门调整的细节。标准 Markdown 要求行尾两个空格才换行，对中文用户极不直觉。插件接入 @bytemd/plugin-breaks 把单次回车翻译为换行，同时在 HTML 输出阶段将每个换行独立包裹为 <p> 段落标签，既保持编辑区的直觉体验，又保证前台语义结构规范。
图片上传改造把原本割裂的三步流程压缩为一步：直接在编辑区点击或拖拽图片，插件通过独立的 upload.php 入口提交到 Z-Blog 附件系统，附带 CSRF Token 防伪造，上传成功后按标准图片语法自动插入源码，多图按序排队上传，全程不打断写作节奏。
安装与上手
将整个 MarkdownEditor 文件夹放入站点 zb_users/plugin/ 目录，登录后台进入插件管理页面找到"Markdown 编辑器"点击启用即可。启用后无需额外配置，直接前往文章编辑页就会看到左右分栏的 Markdown 界面，正文与摘要输入框同时接管，写入与发布流程与原来完全一致，不影响已有文章展示。若样式未更新，按 Ctrl+F5 强制刷新清理浏览器缓存即可。
常见问题
界面未生效或按钮无反应？ 通常是浏览器缓存了旧版静态资源，强制刷新即可；若仍异常，检查 include.php 中引用的 JS 路径在开发者工具 Network 面板是否都返回 200。
图片上传失败？ 优先排查附件目录是否可写，其次查看上传请求响应 JSON 中 msg 字段给出的具体错误，多为 Token 校验或文件大小超限。
前台代码高亮不生效？ 属预期行为。插件前台不注入高亮资源，由启用的主题自行提供渲染方案，避免冲突。
为什么选择它
市面上不乏 Markdown 编辑器方案，但真正针对 Z-BlogPHP 生态做深度适配的并不多见。这款插件不是简单的开源项目搬运，而是从中文写作习惯、Z-Blog 存储机制、前台主题兼容性三个维度逐一打磨的产物：工具栏全面汉化、换行规则贴合中文直觉、双轨存储兼容所有主题、图片上传对接原生附件系统。每一个细节调整背后都有真实的踩坑经历，确保你买到的不是半成品，而是已经过实装验证的成熟工具。
把格式陷阱交给插件，把注意力还给内容本身。
