摘要:[Other] 使用Markdown格式編寫點部落文章
[Tool] 使用Markdown格式編寫點部落文章
開始玩GitHub之後接觸到Markdown格式，在GitHub中每個Repository的README文件，都是以Markdown格式來編寫。使用Markdown格式編寫文件，可以將注意力集中在大綱、標題、內文...等等實際傳達資訊的內容上。不像使用HTML格式編寫文件，除了需要關注上列這些傳達資訊的內容之外，還要去設計字型、顏色、縮排...等等排版上的細節。
當然啦，有一好沒兩好，Markdown格式少了這些排版上的細節，也就代表最終產出的文件顯得比較制式化。不過這個缺點，對於像筆者這種美術天份為零的人反而是種優點，因為筆者自己用HTML格式排出來的文件只能用慘不忍睹來形容。
本篇文章介紹如何使用Markdown格式來編寫點部落文章，並在編寫完畢之後透過工具匯出為HTML格式張貼到點部落。接著透過修改CSS樣式的方式，讓文章在點部落中的呈現樣式，近似於GitHub中Markdown文件的呈現樣式。期望能透過這樣的方式，減少開發人員在編寫點部落文章時，花費在文字排版上的時間。
改版資訊
因應點部落改版，已重新編寫第二版的「使用Markdown格式編寫點部落文章」。
工具下載
對於Markdown格式熟悉的開發人員，直接使用window內建的記事本就可以編寫Markdown格式的文件，但這邊要推薦一個Markdown編輯器：MarkdownPad。MarkdownPad這個編輯器在官方網站上，提供了免費的下載版本，在這個版本中除了提供所見即所得的編輯功能之外，將Markdown格式匯出成為HTML格式、PDF格式等等實用功能也沒有缺少。
文件編寫
於MarkdownPad官網下載免費版本的程式，並且安裝在目標電腦之後，就可以開啟MarkdownPad來編寫Markdown格式的文件。在編寫文件的過程中，除了使用IDE功能來編寫之外，也可以透過直接輸入Markdown格式的方式來編寫，關於MarkdownPad IDE功能的操作說明、Markdown格式的語法說明可以參考下列兩個網址：
這邊要特別一提的是，Markdown格式中插入圖片，跟HTML格式一樣只能插入圖片的超連結，也就是要將圖片先上傳到網路空間，然後才能在Markdown格式中使用。
-
要將圖片上傳到網路空間，可以使用點部落後台管理的檔案管理功能的檔案上傳來完成。
-
上傳之後的圖片，可以使用點部落後台管理的圖片管理功能來取得圖片的超連結。
文件匯出
在文件編寫完畢之後，就可以使用MarkdownPad提供的匯出功能，將Markdown格式匯出成為HTML格式。
- 匯出HTML格式。
文件發佈
取得匯出的HTML文件之後，接下來就是從這份文件中，抽取HTML格式的文章內容，並且轉貼到點部落成為新增文章的文章內容。
-
首先使用記事本開啟匯出的HTML文件，可以看到文章內容被定義在body標籤之內。
-
接著將包含文章內容的body標籤，改寫為div標籤，並且加上.md的CSS Class宣告。
-
最後開啟點部落的新增文章功能，將整段包含文章內容的div標籤從記事本中複製，並且在文章內容的原始碼欄位中貼上。
-
完成上列步驟之後，繼續填寫必要的欄位，並且按下儲存文章，就可以將文章發佈到點部落。
樣式設定
將文章發佈到點部落之後，打開文章網址去觀看剛剛發佈的文章內容，會發現整個排版歪七扭八的。這是因為還沒有將先前匯出的HTML文件裡面所包含的CSS樣式，抽取出來定義到點部落之中。
-
首先使用記事本開啟匯出的HTML文件，可以看到CSS樣式被定義在style標籤之內。
-
接著將style標籤內所包含的CSS樣式抽取出來，並且改寫為.md的CSS Class宣告。這個改寫的步驟有點繁瑣，開發人員可以直接點選下載超連結，來取得改寫完畢的CSS樣式：MarkdownCss下載
-
最後開啟點部落的組態設定功能，將改寫過後的CSS樣式複製，並且在Custom CSS的欄位中貼上。
-
完成上述步驟之後，打開文章網址去觀看剛剛發佈的文章內容，可以看到文章內容近似於MarkdownPad上所呈現的樣式。
範例展示
而在最後，展示一個使用Markdown格式建立的技術文章，這份技術文章除了使用本篇介紹的方法張貼在點部落之外，也直接將Markdown文件做為GitHub中Repository的README文件來發佈。而從最終呈現樣式來看，文章在點部落中的呈現樣式，近似於GitHub中Markdown文件的呈現樣式。 :D
能以更簡潔的文字與程式碼，傳達出程式設計背後的精神。
真正做到「以形寫神」的境界。
