將markdown轉換成html查看。
要將markdown文件轉換成html文件，可以用discount或python-markdown軟件包提供的markdown
# Debian/Ubuntu sudo apt-get install discount
或：
# Debian/Ubuntu sudo apt-get install python-markdown
轉換工作很簡單：
# 用discount提供的markdown工具 markdown -o Release-Notes.html Release-Notes.md # 用python-markdown提供的markdown_py工具 markdown_py -o html4 Release-Notest.md > Release-Notes.html
如果要生成PDF，也很簡單，可以用python-pisa提供的xhtml2pdf：
# Debian/Ubuntu sudo apt-get install python-pisa # 將html轉換成PDF xhtml2pdf --html Release-Notes.html Release-Notes.pdf
所以，你可以在文檔目錄下放置這樣一個Makefile來自動這個過程：
# Makefile MD = markdown MDFLAGS = -T H2P = xhtml2pdf H2PFLAGS = --html SOURCES := $(wildcard *.md) OBJECTS := $(patsubst %.md, %.html, $(wildcard *.md)) OBJECTS_PDF := $(patsubst %.md, %.pdf, $(wildcard *.md)) all: build build: html pdf pdf: $(OBJECTS_PDF) html: $(OBJECTS) $(OBJECTS_PDF): %.pdf: %.html $(H2P) $(H2PFLAGS) $< > $@ $(OBJECTS): %.html: %.md $(MD) $(MDFLAGS) -o $@ $< clean: rm -f $(OBJECTS)
這樣你就可以通過簡單的一個命令生成當前目錄下所有md文件的pdf或html輸出了：
# html 輸出 make html # pdf輸出 make pdf
這里有個問題是如果markdown的內容是中文，那么轉換出來的html在瀏覽器中打開就無法自動識別編碼，pdf更慘，直接是一堆亂碼。這時我們可以借助markdown對html標記的支持來在markdown文件中加入編碼信息。例如我們要將markdown轉換為html4文件，可以在文件的開頭加上meta標記，指明編碼格式：
sed -i '1i\<meta http-equiv="content-type" content="text/html; charset=UTF-8">' *.md
這樣就可以了。另外，最近使用圖靈社區的編輯系統時，markdown會時不時將下划線（_）當作斜體的標記，結果函數名就成了這樣的：
# 實際上是ssl_use_cabundle
sslusecabundle
我建議斜體字標記采用單個星號（*），加粗字體采用兩個星號（**），這樣使用起來就方便多了。當然，這個問題本身在於markdown說用星號或下划線都可以。但實際上，兩個都支持反倒會造成一些問題。比如有的地方用下划線（__粗體__ -> 粗體），有的地方用星號（**粗體** -> 粗體），看起來反倒混亂不堪（選星號*的另一個理由是下划線在內容中出現的概率比星號高很多）。
建議圖靈社區的在線編輯系統指定其中一種，然后在例子中和在線編輯器里都采用統一的一種，這樣大多數人一看就明白該用哪種了。
轉自：
http://www.ituring.com.cn/article/10044 作者：武海峰（ID：acid-free）