WP Githuber MD – WordPress Markdown 语法编辑器

描述

一款为 WordPress 站点提供全功能 Markdown 语法的插件,功能包含 Markdown 编辑器、实时预览、图片粘贴、【HTML 转 Markdown 助手】等等……

详细的文件请参阅 https://github.com/terrylinooo/githuber-md

示范

视频中展示了以下步骤:

  1. 使用 HTML 转换 Markdown 工具把 HTML 转换为 Markdown 语法。
  2. 从 Photoshop 剪下图片的选区范围,然后把它贴到 Markdown 语法编辑器。
  3. 点击【更新】按钮将 Markdown 保存至 post_content_filtered 及将 HTML 保存到 post_content(这是你会看到的结果)。
  4. 检视结果。

插件运作方式

  1. WP Githuber MD 将会储存您的 Markdown 内容至 wp_posts.post_content_filtered 栏位。
  2. 解析 Markdown 语为 HTML语法,储存已解析的 HTML 到wp_posts.post_content 栏位。

此插件会检测您的 Markdown 内容并决定加载哪一套脚本,以防载入不必要的脚本影响加载效率。
例如,假设您启用了语法高亮功能,那么您需要先更新您的帖子,前端效果才会生效。

建议

使用这个插件比较理想的情况是当您才刚开始经营一个新部落格的时候。

如果您打算使用这个插件在现行部落格上,务必要:

  • 停用其它的 Markdown 插件,因为类似的插件可能运作方式一样,在送出文章时转换格式。可能导至重复转码问题。
  • 我的建议是禁用草稿和自动保存功能,在设置页面中有相关设置项。

特色

  • Markdown 编辑器
  • 即时预览。
  • 拼写检查
  • 针对单一文章,启用 / 停用 Markdown。
  • 支持古腾堡编辑器。
  • 支持自定义帖子类型。
  • 支持 Markdown 扩展语法。
  • HTML 转换 Markdown 工具。
  • 图片随贴(支持上传至 imgur.com 及 sm.ms 图床)
  • 代码语法高亮(prism.js 或 hightlight.js)
  • 流程图表。
  • kaTeX 数学公式。
  • 序列图表。
  • 美人鱼 (图表模组)
  • MathJax 数学公式。
  • 表情图示。
  • GitHub 定义的 Markdown 任务列表。
  • 获取远程图像
  • 关键字建议工具。
  • 以及更多…

本地化参与人员

English (en_US) by Colocal.
繁體中文 (zh_TW) by Alex Lion.
简体中文 (zh_CN) by Terry Lin.

版权

WP Githuber MD, Copyright 2018-2020 TerryL.in
WP Githuber MD is distributed under the terms of the GNU GPL

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

屏幕截图

  • HTML 转换 Markdown 工具。
  • 图片随贴。
  • 更新文章然后看结果。
  • 程式语法高亮
  • 美人鱼 (图表模组)
  • kaTeX 数学公式。
  • 流程图表。
  • 序列图表。
  • 设定页面 1(Markdown)
  • 设定页面 3(模组)
  • 设定页面 4(扩充功能)
  • 设定页面 4(设定偏好)

安装

  1. 上传插件的档案到 /wp-content/plugins/wp-githuber-md 资料夹,或者透过 WordPress中 的 “插件” 屏幕安装插件。
  2. 通过 WordPress中 的 “插件” 屏幕启用插件。
  3. 前往插件下的 WP Githuber MD 选单来设定您的 Markdown 选项。
    通过 WordPress中 的 “插件” 屏幕启用插件。

常见问题

您可以在 回报问题 找到您的问题的解答。

评价

2024 年 6 月 1 日
Undoubtedly the best plugin available, and well done too. However, some buttons (e.g. search, h5-h6, clear) present in other similar plugins were missing, so much so that I had to insert them manually, not with little trouble. Therefore, the inclusion of an option to choose the buttons to insert in the toolbar is welcome, or even just a filter that allows you to do so from the theme’s functions.php. 🙂 Another thing missing is the preview of the highlight themes for code. But it is certainly a minor aspect.
2022 年 10 月 15 日
Very helpful! The settings options are straightforward. It odes what it’s supposed to do and it does it well.
2021 年 8 月 24 日
I really like the plugin (hence the 4 stars) but it breaks two things for me. My mobile menu dropdown gets disabled, and it causes a “critical error” when someone tries to make a comment. I turned the plugin off and both errors stopped, turned it on again and they broke again, so I’m sure this is the root cause. I’m running with WordPress 5.8 and my theme is Site Origin North. Not sure whether it’s the version of WordPress or my theme (or both?) in combination with WP Githuber MD but it’s unusable for me.
阅读所有26条评价

贡献者及开发者

“WP Githuber MD – WordPress Markdown 语法编辑器” 是开源软件。 以下人员对此插件做出了贡献。

贡献者

「WP Githuber MD – WordPress Markdown 语法编辑器」插件已被翻译至 2 种本地化语言。 感谢所有译者为本插件所做的贡献。

将“WP Githuber MD – WordPress Markdown 语法编辑器”翻译成您的语言。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

= 1.0.0

  • 首次开放下载使用。

= 1.1.0

  • 加上图片随贴模组。

= 1.2.0

  • 图片随贴 – 提供可上传至 Imgur.com 的功能选项。
  • 更名 “Githuber MD” 为 “WP Githuber MD”。
  • 加入新的设定。

= 1.2.5

= 1.3.0

  • 在 Markdown 编辑器旁边放置 HTML 转换Markdown 的小工具
  • 加入選項讓用戶可以停用 自動儲存功能。
  • 在關於我們加入更多資訊。

= 1.3.1

  • 向下相容于 PHP 5.3 及 WordPress 4.0.x. (已在 PHP 5.3.5 及 WordPress 4.0.25 测试成功)
  • 修改了 HTML 转换 Markdown 小工具和图片随贴的介绍内容。
  • 加入语言包版型
  • 改善 HTML 转换 Markdown 的小工具

= 1.3.2

  • 加入语言包: zh_TW.
  • 修复 Bug。

= 1.4.0

  • = 1.3.2
  • 加入语言包: zh_CN.
  • 修复 Bug。

= 1.4.1

  • 新增行号显示设定。
  • 调整 KaTeX 模组 – 现在可以用 Markdown 语法区块定义 katax 使用。
  • 改进 Markdown 编辑器 – 调整小视窗按纽的外观及修正版面跑版问题。
  • Yoast SEO 有一个 CSS 全域样式名称为 path 使用了动化效果,这个会破坏美人鱼图表模组的 SVG 预览显示,因为他们定义了同样的常见样式名称。我们只好强行移除该动化效果让它正常显示。

= 1.4.2

  • 问题修正: HTML 转 Markdown 小工具。

= 1.4.3

  • 问题修正 #3 – 感谢 wojciehm@github 回报问题。
  • 如果PHP版本未达到最低要求,显示警告。

= 1.5.0

  • 侦测 Jetpack Markdown 模组。

= 1.5.2

  • 修复 bug:插入图片无法运作(问题回报 #6)
  • 支持 KaTeX 内嵌显示。 (功能请求 #7)
  • 添加自定义 Markdown 语法块,支持 HTML 5 figure 标签。(功能请求 #8)

= 1.6.0

  • 支持自定义帖子类型。
  • 加入 启用 Markdown 选项,在编辑器旁。
  • 支援古腾堡编辑器。现在您可以针对文章停用 Markdown 然后回到古腾堡编辑器。

= 1.6.2

  • 在图片随贴模组中加入新的功能选项。 (功能请求 #16)
  • 增加一个选项,在使用媒体库 加入图片可以让用户插入 HTML 到编辑器中(功能请求 #17)
  • 修复 bug:停用对文章类型后,富本文编辑器未出现。 (问题回报 #15)
  • 改进:美化 Markdown 切换器。

= 1.7.0

  • 改进设定页面的用户介面。
  • 在设定页面中加入范例。
  • 问题回报 #22 – 脚尾附注。
  • 功能请求 #19 – 加入对短代码的支援。
  • 及其它问题回报…

= 1.7.1

  • 修正 bug 和一点点改进。

= 1.7.2

  • 修正问题:关闭修订无法作用。
  • 加入赞助资讯。

= 1.7.3

  • 修正问题:#29,问题 #30 及 #31。
  • 修正问题:Markdown extra 未作用。

= 1.7.4

  • 修正 JavaScript 语法错误(打开连结模式)

= 1.8.0

  • 修正问题 #39:在同步卷轴选项关闭时即时预览没有作用。
  • 特色请求 #36:图片随贴 – 支援 sm.ms 图床。
  • 修正 bug:第一次启用插件时无正确注册 register_activation_hook
  • 修正问题:在反安装时套用错误的变数名称。

= 1.8.1

  • 修正问题:wp_get_attachment_url() 无法区分页面是 HTTP 或 HTTPS
  • 修正问题 #38 – 保留行内代码区块。
  • 加入简体中文语言包。

= 1.8.2

  • 修正问题 #42:Markdown 语法在两段行间代码区块中生效。

= 1.8.5

  • 新增功能:Githuber MD 扩充 – 键盘样式的行间代码区块。例:{ctrl}
  • 修正问题:行间代码区块在只有一个字元的情况下无法作用。举例 a。这个问题和 #42 相关。

= 1.8.6

  • 修正问题 #44:无法插入被连结的图片。
  • 修正问题 #45:HTML 转换 Markdown 无法转译表格。

= 1.9.0

  • 新增功能:TOC (内容纲要) 模块。
  • 新增功能:把网址中的& 转换为 &

= 1.9.1

  • 修正问题 #48:因为某些系统未安装 php_fileinfo 因此用 $_FILES['type'] 替代。

修正问题 #52 – 移除字串搜寻的醒目效果。

  • 功能请求 #53: 加入复制到剪贴簿 按纽到代码高亮的区块中。
  • 修正问题 #52 – 移除字串搜寻的醒目效果。
  • Fix issue #57 – Preserve code blocks in a list.

问题 #49:图片插入在文件尾端。

  • 修正问题 #57 – 在列比中保留代码区块。
  • 功能请求 #59:把前端加入的 .css 和 .js 移往行间的 script 区块。
  • 问题 #62:修正 [加入媒体] 按纽对于其它媒体类型档案例如:声音。
  • 修正在 marked.js 中不正确的连结颜色。

= 1.11.0

  • 功能请求 #65:拼写检查。
  • 新增设定在偏好设定。

= 1.11.1

  • 修正问题 #68:无法正确显示 JavaScript 样板本文在代码区块中。
  • 修正问题:内容纲要不该显示在首页在文章列表页。
  • 改进:拼写检查相容性检测。
  • 改进:让 Markdown 语法也可用在代码区块中。

= 1.11.2

  • 修正问题 #31 – 因为修改问题 #57 又重现此问题。

= 1.11.3

  • 修正问题 #70: 当增加特色图片时产生的问题。
  • 修正问题 #71: 支持 Shortcodes Ultimate 插件。

= 1.11.4

  • 修正问题 #72: 语法高亮 – 使用 prism 自动载入器代替。
  • 功能请求 #74: 增加一个选项给对照萤光笔。

= 1.11.5

  • Jetpack compatibility #80, #81, thanks @jeherve
  • 修复问题 #92
  • Remove donation information.

= 1.11.6

  • Fix issue #89 – Code block parsing problems.
  • Fix issue #96 – KaTex not working when using only inline syntax.

= 1.11.7

  • Fix issue #99 – a CSS conflict in menu page.
  • Fix issue #91 – post_id check.
  • Feature request #98 – Add a new option in Preferences.

= 1.11.8

  • Fix issue #107 – Fix parsing inline KaTax syntax.
  • Fix issue #104 – UL list does not display correctly in the preview panel.

= 1.11.9

  • Fix issue #126 – Conflict with WordPress 5.3 ( add_plugins_menu function changes )
  • PR #118 – Allow adding links to other file types rather than only inserting images.

= 1.12.0

  • Feature request #75 – Save images to local folder.
  • New feature – Syntax highlighter by highlight.js
  • Hide support comment option because it doesn’t work now.
  • Update uninstall.php

= 1.12.1

  • Move settings to the option submenu.

= 1.12.2

  • Fix issue #144 – Deregistering autosave script gives error. (Fixed by alpipego. Thanks for contributing.)
  • Fix issue #143 – Unable to upload images to sm.ms. (The v1 API is deprecated.)
  • Fix issue #147 – Update CodeMirror themes.

= 1.13.0

  • New feature – MathJax.

= 1.13.1

  • Bug fix – Missing property in Markdown class.

= 1.14.0

  • Feature request #86, #135 – Emojify module.
  • Fix issue #163 – Update KaTex version.
  • Fix issue #127, #149 – Link opening method.
  • Fix issue #156 – Highlight C code block.
  • Fix issue #120 – FlowChart identification code – flow, which occurs a conflict to Prism.
  • Fix issue #103 – Markdown editor UI – add support to zh_CN

= 1.15.0

  • New feature – Keyword suggestion tool.

= 1.15.1

  • Fix issue #184 – The position of typing dialog should be under the focused line.
  • Fix issue #187 – Task List – Compatible with PHP 7.4

= 1.15.2

  • Fix errors in WP CLI.

= 1.16.0

  • Fix issue #209 – HTML unescaped in code blocks.
  • Fix issue #210 – Inline MathJax is not displayed.
  • Upgrade Mermaid JavaScript library from 8.0.0 to 8.9.0
  • Upgrade KaTax JavaScript library from 0.11.1 to 0.12.0
  • Upgrade Flowchart.js JavaScript library from 1.11.3 to 1.14.1

= 1.16.1

  • Fix issue #253 – KaTax… by xxNull-lsk
  • Fix issue #252 – Bulk action… by hmaragy
  • Improve #252 Update composer.json to allow bedrock installs by jawngee
  • Fix issue #230 – jsdeliver url by Bronya0
  • Test up to WordPress 5.8.1
  • Test up to PHP 8.0

= 1.16.2

  • Test for compatibility with WordPress 6.2.2 and PHP 8.2.5 (No new updates for this version, just testing for compatibility)
  • 修复编码样式。
  • 将 Mermaid.js 更新到 9.4.3

= 1.16.3

  • 为 ImagePaste 模块修复一个安全问题。
  • 为未加载 jQuery 的主题添加 jQuery 依赖。