要将markdown文件转换成html文件,能够用discount或python-markdown软件包提供的markdown工具。html
$ sudo apt-get install discount
或python
$ sudo apt-get install python-markdown
用discount提供的markdown工具转换:浏览器
$ markdown -o Release-Notes.html Release-Notes.md
用python-markdown提供的markdown_py工具转换:markdown
$ markdown_py -o html4 Release-Notest.md > Release-Notes.html
若是要生成PDF,能够用python-pisa提供的xhtml2pdf转换:工具
$ sudo apt-get install python-pisa $ xhtml2pdf --html Release-Notes.html Release-Notes.pdf
也能够在文档目录下放置一个Makefile来自动完成转换过程:ui
# 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)
html输出:编码
$ make html
pdf输出:.net
$ make pdf
若是markdown的内容是中文,那么转换出来的html在浏览器中打开就没法自动识别编码,pdf更惨,直接是一堆乱码。这时能够借助markdown对html标记的支持,在markdown文件中加入编码信息。例如咱们要将markdown转换为html文件,能够在文件的开头加上meta标记,指明编码格式:code
$ sed -i '1i\<meta http-equiv="content-type" content="text/html; charset=UTF-8">' *.md
使用以上的方法,转换出来的效果并不理想,因此尝试使用pandoc去转换,在Ubuntu上使用如下指令安装:htm
$ sudo apt-get autoremove pandoc $ sudo apt-get install cabal-install $ cabal update $ cabal install pandoc
html输出:
$ pandoc Release-Notest.md -o Release-Notes.html
pdf输出:
$ pandoc Release-Notest.md -o Release-Notes.pdf
参考文章
Linux下批量将md文件批量转换为html文件
如何在Linux下使用Markdown进行文档工做
利用Pandoc转换markdown和HTML、LaTeX