Wiz寫Blog? 不會再愛了，全面擁抱Markdown+Pandoc
我們為什么寫作？
自從人們開始寫作，寫作便是記錄、抒發、批判、反省的好工具。從石板上的刻印到筆墨紙硯，再到如今的信息時代。從靜態的個人主頁到托管博客，從個人博客到微博，從wordpress到jekyll。無數投入寫作中的人們寫作的目的大同，寫作的方式越簡單越好，這樣才能讓我們專注於寫作而不是為其他格式所困擾。另外現在智能終端快速普及，文件格式的多平台使用也成為了寫作的一大問題。
為了更好的寫作,今天介紹的 Markdown & Pandoc 便能提供完美的輔助。
Markdown的用法
1 .Markdown是什么?
Markdown 是一種輕量級標記語言，創始人為John Gruber和Aaron Swartz。它允許人們“使用易讀易寫的純文本格式編寫文檔，然后轉換成有效的XHTML(或者HTML)文檔”。這種語言吸收了很多在電子郵件中已有的純文本標記的特性。 [1]
2 .為什么要用Markdown?
windows下常用的編輯工具是word,mac上常用的編輯工具是page,linux上常用的編輯工具就是vim了，一份文章編輯完后為了要在不同平台中保存完整的模樣時就必需同時准備多種文本格式的文件，這是多么痛苦的一件事。我們寫作的初衷是為了寫作呀，反而被這些格式煩惱。所以我們要用Markdown,它讓你關注內容，格式怎么顯示不是要你在寫得時候關注的。而在寫Markdown時你只需要用一個純文本的方式進行，不用擔心平台與格式的困擾。
3 .Markdown的語法
Markdown 的語法全由一些符號所組成，這些符號經過精挑細選，其作用一目了然。比如：在文字兩旁加上星號，看起來就像強調。Markdown 的列表看起來，嗯，就是列表。Markdown 的區塊引用看起來就真的像是引用一段文字，就像你曾在電子郵件中見過的那樣。
最常用格式
空一行（兩個回車）分段 行末加兩個或多個空格才是真正的換行，否則正常的一個回車就像在 HTML 代碼中一樣，被當作空格處理 插入鏈接： [鏈接文字](url) 圖片跟鏈接很像，在前面加個嘆號：
列表
* 無序(沒有編號的)列表中的一項* 一個子項，要以一個制表符或者4個空格縮進* 無序列表中的另一個項1. 有序(排好序，有編號的)列表中的一項2. 有序列表中的另一個項
標題
# 一級標題#### 四級標題一級標題===================二級標題--------------------
代碼
代碼可以采取兩種方法：
一是用（`）將代碼包起來
夾雜着`一些代碼`的文字內容,
二是在代碼塊前面加上4個空格或者一個TAB
import random class CardGame(object): """ a sample python class """ NB_CARDS = 32 def __init__(self, cards=5): self.cards = random.sample(range(self.NB_CARDS), 5) print 'ready to play'
代碼高亮可以由github提供的js實現
分割線
要生成水平分割線，可以在單獨一行里輸入3個或以上的短橫線、星號或者下划線實現。短橫線和星號之間可以輸入任意空格。以下每一行都產生一條水平分割線。
===========************_ _ _ _ _
Markdown的常用語法差不多就是這些了，詳細的介紹請參考Markdowm 語法說明
4 .Markdown的常用編輯工具
- Mac等平台下推薦Mou
- Windows平台推薦MarkdownPad【左邊是Markdown源文件，右邊是相應的html文件，所見即所得】
- Sublime Text編輯器是我的最愛，並且它是跨平台的，結合Markdown preview插件能更好的編輯,【使用Package Control安裝，用Ctrl+B編譯，即可得到Markdown源文件相應的html文件】；
- Sublime上安裝Markdown Editing后，就可以直接使編輯器在編輯時所見即所得，只是灰色背景看着有點眼。
- markdown-here借助Chrome插件，將gmail、Evernote、Hotmail等寫作窗口變為Markdown在線寫作窗口【比如，gmail寫郵件過程中，運用markdown語法，再右鍵選擇markdown Toggle 即可裝換為相應的html形式的結果】
- web版推薦國人草依山寫的MaHua,支持vim快捷鍵和多種主題。
Markdown越來越流行，不是因為它復雜，而是因為它足夠簡單。嘗試過MD后就能體會到單純的寫作帶來的快樂，一般Markdown文件保存格式都是以md、mdownx現實。為了文檔的分享,多平台的使用，需要對MD進行格式轉化。這是就更體現了它的方便之處，它是本身是一個結構標記語言，能對多種格式文檔進行轉換，這里介紹一款強大的格式轉換工具 Pandoc 。
Pandoc 格式轉換的瑞士軍刀
1 .Pandoc的介紹
Pandoc是一個用於從一種標記格式轉換為另一種的Haskell庫，它的功能是在多種常見的標記語言進行相互轉換。
其中包括 Markdown, reStructuredText, Textilte, HTML, PDF,LaTeX 等。利用它，你可以用簡單的 Markdown 語法生成pdf文檔，還可以寫 Beamer 演示文稿。更強大的是，它還能將以上提到的這些語言所寫文件轉換成 xdoc 文檔。下面這張圖展示了 Pandoc 讓人吃驚 的功能集，不愧為文件轉換中的瑞士軍刀：
2 .Pandoc的用法
2.1 Web版Pandoc
首先我們可以看下Pandoc的官網 http://johnmacfarlane.net/pandoc/
在介紹中我們知道Pandoc支持linux,Mac OS,Win多平台，還有簡易的web版提供我們在線轉換格式。打開web版 http://johnmacfarlane.net/pandoc/try,便可以進行簡單的格式轉換了。不過網頁版的反應速度不是很快，不適合大型文件的格式轉換，一兩篇文章還是可以的。
2.2 Linux版Pandoc
就我自己用的ubuntu下安裝Pandoc,還算是非常簡單的。以下是ubuntu下的使用步驟:
sudo apt-get install pandoc
如果apt-get安裝的pandoc功能不齊全，可以如官網上一樣先安裝cable,再安裝pandoc:
sudo apt-get install cabal-installcabal updatecabal install pandoc
然后就可以嘗試着用一下了：
pandoc demo.md -o demo.html
這樣便可以簡單的將demo的markdown文件轉換成html文檔了。另外還可以強制格式轉換如下：
pandoc demo.txt -o demo.html -f markdown -t html
上面的代碼便是將demo.txt中的文檔以markdown的格式轉換成html並存入demo.html中了。
最關鍵的 PDF文件 到了，PDF文檔能在不同平台保持一致的表現，是許多文檔傳輸的首選。在轉換PDF之前,還需要安裝一個texlive的包：
sodu apt-get install texlive
然后便可以自如的轉換PDF文件了：
pandoc demo.md -o demo.pdf
英文文件轉換狀況良好，中文字體問題請參考Pandoc 用命令行轉換標記語言
Markdown與Pandoc的用法也就說到這了，無疑它們搭配起來會讓寫作變得更加簡單專注，這也就是我們的初衷。另外在寫作中多結合Git,將文檔推到GitHub上會是很好的嘗試。
參考文檔
- Markdown寫作淺談 , 陽志平
- 黑魔法利器pandoc , 雁起平沙
- Pandoc 用命令行轉換標記語言 , 林雪凡
- Pandoc 官網 , John MacFarlane
- Markdown 語法說明 , riku