Linux系統(tǒng)下Markdown使用教程
Markdown是一種輕量級(jí)的標(biāo)記語言,由于語法簡單,規(guī)則易懂,被很多程序員所喜愛。下面由學(xué)習(xí)啦小編為大家整理了linux下的Markdown命令的簡介和使用,希望對大家有幫助!
linux系統(tǒng)下Markdown命令的簡介和使用
Linux系統(tǒng)下Markdown簡介
Markdown 是一種輕量級(jí)的「標(biāo)記語言」,它的優(yōu)點(diǎn)很多,目前也被越來越多的寫作愛好者,撰稿者廣泛使用。看到這里請不要被「標(biāo)記」、「語言」所迷惑,Markdown 的語法十分簡單。常用的標(biāo)記符號(hào)也不超過十個(gè),這種相對于更為復(fù)雜的 HTML 標(biāo)記語言來說,Markdown 可謂是十分輕量的,學(xué)習(xí)成本也不需要太多,且一旦熟悉這種語法規(guī)則,會(huì)有一勞永逸的效果。
Linux系統(tǒng)下使用Markdown
1、在Linux系統(tǒng)中,編輯markdown可以用retext工具
# Debian/Ubuntu
sudo apt-get install retext
retext Release-Notes.md
2、使用python-markdown將markdown文件轉(zhuǎn)換成html文件
markdown_py -o html4 Release-Notest.md > Release-Notes.html
3、使用python-pisa將html轉(zhuǎn)換成pdf文件
xhtml2pdf --html Release-Notes.html Release-Notes.pdf
4、通過在文件的開頭加上meta標(biāo)記解決markdown的內(nèi)容是中文亂碼
sed -i '1i\' *.md
Linux下Markdown的安裝及使用
在Linux系統(tǒng)中,編輯markdown可以用retext工具:
# Debian/Ubuntu
sudo apt-get install retext
retext Release-Notes.md
要將markdown文件轉(zhuǎn)換成html文件,可以用discount或python-markdown軟件包提供的markdown:
# Debian/Ubuntu
sudo apt-get install discount或:
# Debian/Ubuntu
sudo apt-get install python-markdown轉(zhuǎn)換工作很簡單:
# 用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轉(zhuǎn)換成PDF
xhtml2pdf --html Release-Notes.html Release-Notes.pdf所以,你可以在文檔目錄下放置這樣一個(gè)Makefile來自動(dòng)這個(gè)過程:
# 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)這樣你就可以通過簡單的一個(gè)命令生成當(dāng)前目錄下所有md文件的pdf或html輸出了:
# html 輸出
make html
# pdf輸出
make pdf這里有個(gè)問題是如果markdown的內(nèi)容是中文,那么轉(zhuǎn)換出來的html在瀏覽器中打開就無法自動(dòng)識(shí)別編碼,pdf更慘,直接是一堆亂碼。這時(shí)我們可以借助markdown對html標(biāo)記的支持來在markdown文件中加入編碼信息。例如我們要將markdown轉(zhuǎn)換為html4文件,可以在文件的開頭加上meta標(biāo)記,指明編碼格式:
sed -i '1i\' *.md這樣就可以了。另外,最近使用圖靈社區(qū)的編輯系統(tǒng)時(shí),markdown會(huì)時(shí)不時(shí)將下劃線(_)當(dāng)作斜體的標(biāo)記,結(jié)果函數(shù)名就成了這樣的:
# 實(shí)際上是ssl_use_cabundle
sslusecabundle我建議斜體字標(biāo)記采用單個(gè)星號(hào)(*),加粗字體采用兩個(gè)星號(hào)(**),這樣使用起來就方便多了。當(dāng)然,這個(gè)問題本身在于markdown說用星號(hào)或下劃線都可以。但實(shí)際上,兩個(gè)都支持反倒會(huì)造成一些問題。比如有的地方用下劃線(__粗體__ -> 粗體),有的地方用星號(hào)(**粗體** -> 粗體),看起來反倒混亂不堪(選星號(hào)*的另一個(gè)理由是下劃線在內(nèi)容中出現(xiàn)的概率比星號(hào)高很多