WordPress Markdown 編輯器外掛 – WP Githuber MD

一個為 WordPress 網站提供全功能 Markdown 語法的外掛，功能包含 Markdown 編輯器、即時預覽、圖片隨貼、HTML 轉換 Markdown 小幫手等等。

運作方式

1. WP Githuber MD 將會儲存您的 Markdown 內容至 wp_posts.post_content_filtered 欄位。
2. 解析 Markdown 語為 HTML語法，儲存已解析的 HTML 到 wp_posts.post_content 欄位。

這個外掛會偵測您的 Markdown 語法內容來決定前端套件是否被載入，以避免載入不必要的套件增加載入時間。
舉個例子。 程式代碼高亮，您必須要更新文章內容才會讓前端頁面生效。

示範

GIF 動畫

這個動畫圖片示範了以下步驟:

1.使用 HTML 轉換 Markdown 工具把 HTML 轉換成 Markdown。

2. 從 Photoshop 複製並剪下選取範圍，然後貼上至 Markdown 編輯起器中。

3. 點擊 "更新" 按紐把 Markdown 語法格式的本文存進 post_content_filtered 欄位，並儲存 HTML 至 post_content 欄位。（如同頁面顯示結果）
4. View the result.

影片

https://youtu.be/it1noNCTXa4

系統需求

• PHP 版本 5.3 以上。
• WordPress 版本 4.0 以上。
• 已經過測試至 5.1.1 版本

下載

來源	載點
WordPress 官方外掛目錄	https://wordpress.org/plugins/wp-githuber-md
GitHub 儲存庫	https://github.com/terrylinooo/githuber-md/releases
PHP Composer	composer create-project terrylinooo/githuber-md wp-githuber-md

安裝

1. 上傳外掛的檔案到 /wp-content/plugins/wp-githuber-md 資料夾，或者透過 WordPress中 的 “外掛” 屏幕安裝外掛。
2. 通過 WordPress中 的 “外掛” 屏幕啟用外掛。
3. 前往外掛下的 WP Githuber MD 選單來設定您的 Markdown 選項。

建議

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

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

• 停用其它的 Markdown 外掛，因為類似的外掛可能運作方式一樣，在送出文章時轉換格式。可能導至重複轉碼問題。
• 我個人建議是停用修訂和自動存檔，在外掛設定頁面中有提供。

特色

• Markdown 語法編輯器。
• 即時預覽。
• 針對單一文章，啟用 / 停用 Markdown。
• 支援古騰堡編輯器。
• 支援客製的文章類型。
• 語法醒目提示。
• HTML 轉換 Markdown 小工具。
• 圖片隨貼。（支援上傳至 Imgur）
• 流程圖。
• KaTex。
• 順序圖表。(#1)
• 美人魚（圖表模組）。
• GitHub 定義的 Markdown 任務列表。
• Githuber MD 擴展的 Markdown 語法。
• Markdown extra…（擴展語法）

已知問題

#1– 序列圖表：這個功能只有在 WordPress 版本大於 4.5 以上出現，因為之前它使用了 underscore.js 而會和早期 WordPress 的圖片上傳功能產生衝突。您可以使用 Mermaid 模組取代它。我們已 WordPress 4.5 以下的版本隱藏這個選項。