Linux系统下Markdown使用教程

学习啦在线学习网 　　Markdown是一种轻量级的标记语言，由于语法简单，规则易懂，被很多程序员所喜爱。下面由学习啦小编为大家整理了linux下的Markdown命令的简介和使用，希望对大家有帮助!

　　linux系统下Markdown命令的简介和使用

　　Linux系统下Markdown简介

学习啦在线学习网 　　Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

　　Linux系统下使用Markdown

学习啦在线学习网 　　1、在Linux系统中，编辑markdown可以用retext工具

学习啦在线学习网 　　# Debian/Ubuntu

学习啦在线学习网 　　sudo apt-get install retext

　　retext Release-Notes.md

　　2、使用python-markdown将markdown文件转换成html文件

　　markdown_py -o html4 Release-Notest.md > Release-Notes.html

学习啦在线学习网 　　3、使用python-pisa将html转换成pdf文件

　　xhtml2pdf --html Release-Notes.html Release-Notes.pdf

　　4、通过在文件的开头加上meta标记解决markdown的内容是中文乱码

　　sed -i '1i\' *.md

学习啦在线学习网 　　Linux下Markdown的安装及使用

学习啦在线学习网 　　在Linux系统中，编辑markdown可以用retext工具：

　　# Debian/Ubuntu

　　sudo apt-get install retext

　　retext Release-Notes.md

　　要将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\' *.md这样就可以了。另外，最近使用图灵社区的编辑系统时，markdown会时不时将下划线(_)当作斜体的标记，结果函数名就成了这样的：

　　# 实际上是ssl_use_cabundle

　　sslusecabundle我建议斜体字标记采用单个星号(*)，加粗字体采用两个星号(**)，这样使用起来就方便多了。当然，这个问题本身在于markdown说用星号或下划线都可以。但实际上，两个都支持反倒会造成一些问题。比如有的地方用下划线(__粗体__ -> 粗体)，有的地方用星号(**粗体** -> 粗体)，看起来反倒混乱不堪(选星号*的另一个理由是下划线在内容中出现的概率比星号高很多