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 欄位。

This plugin will detect your Markdown content and decide what scripts will be loaded, to avoid loading unnecessary scripts.
For example, if you enabled Syntax highlight, you have to update your post again to take effects.

建議

使用這個外掛比較理想的情況是當您才剛開始經營一個新部落格的時候。

如果您打算使用這個外掛在現行部落格上,務必要:

  • 停用其它的 Markdown 外掛,因為類似的外掛可能運作方式一樣,在送出文章時轉換格式。可能導至重複轉碼問題。
  • 我的建議是停用草稿和自動存檔功能,選項在設定頁中。

特色

  • Markdown 編輯器
  • 即時預覽。
  • 拼寫檢查
  • 針對單一文章,啟用 / 停用 Markdown。
  • 支援古騰堡編輯器。
  • 支援客製的文章類型。
  • HTML 轉 Markdown 小幫手。
  • 圖片隨貼(支援上傳至 imgur.com 及 sm.ms 圖床)
  • Syntax highlight.
  • 流程圖。
  • kaTeX 數學公式。
  • 序列圖表。
  • 美人魚 (圖表模組)
  • MathJax 數學套件。
  • 表情圖示套件。
  • GitHub 定義的 Markdown 任務列表。
  • Markdown extra…(擴展語法)
  • 關鍵字建議工具。

本地化參與人員

Traditional Chinese (zh_TW) by Alex Lion.
Simplified Chinese (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 選項。

常見問題集

您可以在 回報問題 找到您的問題的解答。

使用者評論

2020 年 6 月 8 日
这款插件在将文章存入数据库之前,会把 markdown 字符串转换成 html 字符串,而在编辑时,将 html 字符串转换回 markdown 字符串。 虽然目前来说,一切工作得很好,转换的过程中没有出现问题,但是这个转换的过程,终究还是会导致一些数据的丢失,无法最大程度地保留用户输入的最原始的数据。比如说在一行的结尾添加的两个空格,转换成 html 后再转换回 markdown,就丢失了。有些 markdown 解析器依赖这两个空格进行换行。 希望能向 Parsedown Party 这款 markdown 编辑器插件学习一下,将用户输入的 markdown字符串直接存入数据库,而在用户阅读文章时,将 markdown 字符串解析成 html 。 当然了,尽管存在这个问题,但是这款编辑器插件目前来说还是最优秀的, 与之相比,Parsedown Party 存在的问题也不少。
2020 年 5 月 15 日
Hi, like s.dudchenko and others i love your plugin. Best MD Plugin on WP. On my personal website i use grav CMS because static site generators have so much great options and even better workflows as database driven solutions. Your plugin is a great bridge to get this feeling. You would be my hero and perhaps for so many guys if WP Githuber MD get an option / feature to import RAW from Gitlab/Github. All git sync plugins on github and on wordpress.org are aweful in combination with ugly gutenberg or classic editor. I tried so much, there is no toolchain to combine the power of git with a really good MD Editor/wordpress file management. That's the point, why grav CMS is Nr.1 for my personal work. At work i am glad that the government allowed us to use WordPress 🙂 You would be our work-god if WP Githuber MD get a git push/pull feature in the future <3 Please keep pushing WP Githuber MD. Like many others here, this is my first WordPress comment, registered an account 10 min ago - only for this awesome plugin!!!
2020 年 3 月 24 日
Great plugin, thanks to it I came back from Grav CMS to WordPress. Guys, great job, keep it up! Thank you for your work.
2020 年 3 月 8 日
Delivers what it promises (and more). Sleek and sturdy, it's a game changer for Knowledge Bases. Love it!
2019 年 8 月 27 日
It's very useful and good to use when I write with markdown!
閱讀全部 13 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈WP Githuber MD – WordPress Markdown 語法編輯器〉的開發相關工作。

參與者

WP Githuber MD – WordPress Markdown 語法編輯器 外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將 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.
  • Fix bugs.

= 1.4.0

  • 加入美人魚模組。
  • 加入語言包: 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 (內容綱要) 模組。
  • 新增功能:把網址中的&amp; 轉換為 &

= 1.9.1

  • 修正問題 #48:因為某些系統未安裝 php_fileinfo 因此用 $_FILES['type'] 替代。

= 1.10.0

  • 功能請求 #53: 加入複製到剪貼簿 按紐到代碼高亮的區塊中。
  • 修正問題 #52 – 移除字串搜尋的醒目效果。
  • 修正問題 #57 – 在列比中保留代碼區塊。

= 1.10.1

  • 功能請求 #59:把前端加入的 .css 和 .js 移往行間的 script 區塊。
  • 問題 #62:修正 [加入媒體] 按紐對於其它媒體類型檔案例如:聲音。
  • 修正在 marked.js 中不正確的連結顏色。
  • 問題 #49:圖片插入在文件尾端。

= 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 相容性 #80, #81, 感謝 @jeherve
  • 修正問題 #92
  • 移除捐款資訊。

= 1.11.6

  • 修正問題 #89 – 程式碼區塊解析問題。
  • 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.
  • 新功能 – 語法高亮模組 highlight.js
  • Hide support comment option because it doesn’t work now.
  • 更新 uninstall.php

= 1.12.1

  • 設定連結移到選項次選單。

= 1.12.2

  • Fix issue #144 – Deregistering autosave script gives error. (Fixed by alpipego. Thanks for contributing.)
  • 修正問題 #143 – 無法上傳圖片至 sm.ms. (第 v1 版 API 已停用)
  • 修正問題 #147 – 更新 CodeMirror 樣式。

= 1.13.0

  • 新功能 – MathJax 數學模組。

= 1.13.1

  • 修正臭蟲 – Markdown 類別缺少屬性參數。

= 1.14.0

  • 功能請求 #86, #135 – Emojify 表情圖示模組。
  • 修正問題 #163 – 更新 KaTex 套件版本。
  • 修正問題 #127 及 #149 – 連結開啟的方式。
  • 修正問題 #156 – 語法高亮的 C 程式碼區塊
  • 修正問題 #120 – 流程圖識別代碼 – flow,與 Prism 套件衝突。
  • 修正問題 #103 – Markdown 編輯器界面 – 加入支援簡體中文。

= 1.15.0

  • 新功能 – 關鍵字建議工具。