Author: Duqi
Date : 2013.5.25

---

前言

Markdown+Pandoc，可以把自己的寫作內(nèi)容，變成世界上已有的任何格式的文件，包括很炫的slide，html5。沒有人（或者我沒看到）總結(jié)過這些內(nèi)容，導(dǎo)致我走了很多彎路才最終打通任督二脈，特此紀(jì)念。
了解Markdwon以后，我的寫作世界，只有它；看到Pandoc格式轉(zhuǎn)換以后，對生成的slide和pdf羨慕的不行。那時，自己期望以后的寫作是這樣的：首先用Markdown把自己的想法寫下來；其次，通過Pandoc，把寫好的Markdown文件，轉(zhuǎn)換成Slide或者PDF。如此而已。
但是，我一直對于pandoc不知道怎么去使用。問了一些人，查了很多網(wǎng)頁，都沒有寫如何去使用pandoc，直到，我在github上搭建Blog，安裝Ruby，以及安裝了Jekyll，才最終發(fā)現(xiàn)我會使用Pandoc了?？梢姡?strong>機(jī)遇是給有準(zhǔn)備的人。
這周準(zhǔn)備R的分享，特意嘗試用Markdown和Pandoc準(zhǔn)備資料。用Markdown寫了10分鐘的內(nèi)容，然后用Pandoc“秒殺”了一個Slide的Html的文件，效果不錯。
鑒于個人對于過程和效果的喜歡，特別整理，分享給有緣人。 個人估計(jì)，有緣人看到以后，必定會引起寫作界的一波學(xué)習(xí)熱！

一、Markdown使用

Markdown，就像一個人的任脈。它簡潔，方便，只要集中精力寫文章就好，排版不用管。它的語法如此簡單，簡單的連一個初中生就可以10分鐘學(xué)會去用，5分鐘寫一個例子，就會了。此言真不虛。比如，我要寫一篇文章,可以這么寫：

# 我的工作
- 工作在Etao
我屬于阿里媽媽，是的。你沒看錯，就是阿里媽媽。
- 工作是BI
我的工作是BI.BI？啥？就是。。。就是。。那個。
`- 工作薪水
薪水？老板不讓說。不告訴你。

展現(xiàn)的樣式呢，是這樣的：

我的工作

• 工作在Etao
  我屬于阿里媽媽，是的。你沒看錯，就是阿里媽媽。
• 工作是BI
  我的工作是BI.BI？啥？就是。。。就是。。那個。
• 工作薪水
  薪水？老板不讓說。不告訴你。

哇，簡單么？#就是標(biāo)題的代表，一個#是一級標(biāo)題，兩個#是二級標(biāo)題，以此類推。如果要引用，就使用>。多么簡單的美好??！其他的使用方法，大家可以去自己學(xué)習(xí)一下，你會體會到什么是簡單的美好！Markdown的內(nèi)容寫好以后，保存成*.md文件。

二、Pandoc使用

Pandoc，這個不知道怎么發(fā)音，google也沒找到。好吧，我就讀做panda吧，誰讓它是國寶。
Pandoc的運(yùn)行，是在命令行里面?？墒?，沒那么簡單，不是任何一個cmd都可以。你必須要下載Pandoc，請參考這里.根據(jù)自己的os，選擇Windows 或者其他。
安裝以后，記得Pandoc的目錄是啥，然后再到cmd里面去操作一些失傳已久的doc命令，轉(zhuǎn)換到pandoc的路徑下。
我個人習(xí)慣，是把要轉(zhuǎn)換的文件，比如test.md，放到pandoc的路徑下，這樣在使用pandoc轉(zhuǎn)換的時候，不用輸入太多的路徑（尤其是我們很多路徑是中文，怕可能有一些問題）。當(dāng)然，也可以調(diào)用其他路徑的文件，只要自己覺得舒服。
pandoc，就像linux下的iconv，可以把其他格式的文件，轉(zhuǎn)化成自己想要的格式。具體的格式參考請看這里。
個人常用的有兩個格式轉(zhuǎn)換：

• a>md文件轉(zhuǎn)換成html5
  pandoc -s --mathml -i -t dzslides test.md -o test.html
• b>md文件轉(zhuǎn)換成pdf
  pandoc -t beamer test.md -o test.pdf

這里強(qiáng)調(diào)一點(diǎn)，如果想轉(zhuǎn)成PDF文件，要安裝LATEX。推薦安裝MiKTex。但是，中文轉(zhuǎn)PDF，因latex支持中文差，轉(zhuǎn)換有問題。對于Latex熟悉的人，可以參考這個，看是否能解決中文轉(zhuǎn)slide pdf的問題。
文件轉(zhuǎn)換完成以后，如果有一些地方不合適，可以調(diào)整原始的md文件，再轉(zhuǎn)換一次。等熟練以后，從寫，到轉(zhuǎn)換就非常迅速了。 當(dāng)然，Pandoc還有很多的轉(zhuǎn)換格式，大家可以自己去研究發(fā)覺。
記得有好的東西，要分享。

后記

雖然偶不美，但是，對于任何美的東西，尤其是設(shè)計(jì)或者排版，或者操作界面，自己還是很熱衷的。使用Pandoc，自己當(dāng)初只是喜歡Slide的樣式，不用去辛辛苦苦的做PPT,就可以有超過PPT的效果，何樂而不為呢？還有Html5，哦，真的是很炫。
關(guān)于Pandoc的使用，我沒有過多的去研究。只是把自己常用的幾個功能熟悉了一下。時間，真的真的很寶貴，不知不覺就從指縫中溜走了。所以，我只能在滿足自己需求情況下，去使用pandoc。
期待大家更多的分享！