在 WordPress 使用 Markdown 撰寫文章

Markdown 是一個輕量級的標記語言,讓你用簡單的方式編輯文件,最後轉換成 HTML 輸出,被廣泛的應用在技術文件撰寫,例如 GitHub、Stack Exchange 都可以看到它的蹤跡。雖然他好棒棒,但是跟傳統的編輯方式相比,各有優缺,假如你想像 Word 一樣編輯文章,那麼建議採用原有的視覺化編輯器,但如果你是個技術咖又或是想要變潮的 WordPress 使用者,不妨試試看。


試著用 Markdown 寫文章,結果…

Markdown 是個網路內容的寫作語言,最主要的目的是讓文章編寫的可讀性提高。傳統使用 HTML 進行超連結、文字大小等設定,必須要用 HTML 標籤包起來,屬性多的時候,原始碼變得很長,維護不易。另外,處理程式碼縮排與空白字元是件令人頭痛的事,儘管有程式碼亮高的套件協助排版,但是使用 WordPress 視覺化編輯器時,句首的空白字元會被吃掉,不得不尋找新的解決方案。為了評估是否採用 Markdown,我稍微列出在 WordPress 使用 Markdown 的優缺點:

優點 

  • 避免輸出的 HTML 夾雜太多無用標籤 (用視覺化編輯器常無意間拉出很多垃圾)
  • 解決程式碼縮排、空白符號的問題
  • 未來能無痛移植至 Markdown 平台

 缺點

  • 仍需要使用 HTML 標籤,例如:調整文字顏色、位置、圖片大小、文章繼續閱讀
  • 編輯器非所見即所得,需要習慣 Markdown 的編輯方式

說實話,我猶豫很久,到底要不要採用 Markdown ,儘管只列了兩個缺點,但那個是非常大的痛點啊。使用 WordPress 當然是希望網頁漂漂亮亮,編輯方式簡單方便,假如寫文章還要透過 HTML 調整文字顏色、圖片大小等等瑣事,真的會讓人失去寫作興致。

後來,我向 Markdown 妥協,花了不少時間,把所有文章改成 Markdown 型式,畢竟我的文章類型多半與科技產物有關,不需要五顏六色華麗的裝飾,簡簡單單就好。

可是,我慢慢又發現,這樣不行,我需要多點變化。

與原本的程式筆記路線不同,我想寫些其他有趣的事,其中包括了影集推薦系列文章。經過幾次揣摩,分析瀏覽量,我發現如果都是單調的配置,沒有顏色、沒有表情符號點綴,實在難以奪人眼球,感覺是自廢武功,浪費 WordPress 原有的強大編輯功能。

於是,我又換回來了…

繞了一圈,返回原地,至少我努力的嘗試過了,Markdown 不適合娛樂主題的文章,還是撰寫技術文件比較實在,各位也衡量看看自己的寫作方向,想清楚再下手囉。


Markdown 必備外掛,使用 WP Editor.MD 即時預覽

現在 Jetpack 已經支援 Markdown 語法了,你只要安裝這個套件,開啟 Markdown 功能就可以開始撰寫。只不過他建議你不要使用視覺化編輯器,說會造成一些錯誤,甚麼?我就是想要邊寫邊看結果阿!好在有好心人 (淮城一只猫) 撰寫了視覺化套件,直接下載安裝 WP Editor.MD,就會發現編輯器變成兩欄囉!

WP Editor.MD

這個 WordPress 專屬的編輯工具,使用 Jetpack 解析 Markdown,結合開源軟體 Editor.MD,提供程式碼量高、表情符號,用起來挺方便的。


推薦幾個輔助工具

原本要寫個工具來批次轉換舊文章成 Markdown 格式,後來還是把全部文章看過,順便調整些用字遣詞。這幾個工具替我節省不少時間,推薦給大家

我會將 HTML 轉成 Markdown,接著確認是否有漏掉的 HTML 需要轉換,程式碼的排版是否正確。安裝完 WP Editor.MD,打開舊文章會看到 HTML 的格式

使用線上工具轉完的 Markdown 再貼回編輯器,修正一些標籤,例如繼續閱讀需要使用 HTML 格式插入


後記

做完這件事,開始覺得內容農場真的太容易拉,根本也不用寫程式,把別人文章偷過來,應用些工具隨便可以區分出文字、程式碼、圖片段落,最後塞廣告就能撈錢了。儘管近年來內容農場開始透過合法管道獲取文章,文章品質也不錯,可是賺錢的都是平台,那些辛苦耕耘的寫手呢?是不是有規範能建立保障或是分潤?小蝦米無法打擊大鯨魚,我改變不了大環境,但相信 Google 的理念「Don’t be evil」,一方面看看 Google 會怎麼做,一方面也持續我的初衷,希望這裡的文章們,都能幫助到需要幫助的人。


平時會觀察網路行銷、雲端運算與資訊安全等議題,曾在趨勢科技擔任實習生、 GCP 專門家擔任技術文章寫手,也擔任過 C、JAVA、雲端運算等課程助教。