MarkDown常用语法汇总

Chip Platform Rockchip
1

Markdown是一种轻量级的标记语言，语法十分简单，目前也被越来越多的写作爱好者，撰稿者广泛使用。我们日常写文档过程中，最麻烦的莫过于排版了，比起使用word文档，我认为Markdown写文档更加方便、排版也十分好看。下面就介绍以下markdown的一些常用语法。
（由于下面文字是Markdown编写的，而帖子不支持markdown，所以想看效果请看这里http://168.168.0.253:9000/blog/post/lxp@t-chip.com.cn/8bf444b68c0c或者复制下面文字到支持markdown的编辑器）
##标题
在Markdown中，一段文字被定义为标题，在文字前面添加#号就可以了：
#一级标题
##二级标题
###三级标题
#一级标题、##二级标题、###三级标题

##引用
当我们需要引用一段文字的时候，例如

这是一段引用的文字

在句子开头添加一个>:
>这是一段引用的文字

##代码区块
代码区块是我们最常用的功能了。在HTML中，我们一般是使用<pre></pre>包裹代码块。MarkDown语法中我们当然可以使用<pre></pre>，另外，我们也能通过输入4个空格或者1个制表符实现。

function HelloWorld(){
//代码
}

##代码关键字
有时候我们需要在文档里引用一小段代码，这时候我们可以通过``包裹关键字,与有一样的效果:

helloWorld()

##列表
Markdown 支持有序列表和无序列表。

###无序列表
无序列表使用星号、加号或是减号作为列表标记,符号前后要有空格，而在符号前面添加一个空格，可变为下一级子项。

  • 这里使用星号
  • 这里使用加号
  • 这里使用减号
  • 一级目录
  • 一级目录子项
  • 一级目录子项
    • 二级目录子项

###有序列表
有序列表有数字与.组成，.后需要有空格。

  1. 测试1
  2. 测试2
  3. 测试3

#表格

表格在 Markdown中使用比较麻烦

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | \$1600 |
| col 2 is      | centered      |   \$12 |
| zebra stripes | are neat      |    \$1 |

这种语法生成的表格如下：

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1
#斜体 粗体
在MarkDown中，只要在文字前后添加*就能显示斜体（一般用于强调）；添加**则显示粗体
斜体
粗体
#图片

要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

行内式的图片语法看起来像是：

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

一个感叹号 !
接着一个方括号，里面放上图片的替代文字
接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 ‘title’ 文字。
参考式的图片语法则长得像这样：

![Alt text][id]

「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：

到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 标签。
#链接
用<>包裹起来的文字，MarkDown会把他转为链接

<http:\\www.baidu.com>

http:\\www.baidu.com
#反斜杠
\可以将一些含有特殊意义的字符转为普通字符，例如

*test*

我不希望显示斜体，而是显示*test*的时候，我可以使用\,将*转为普通字符

\*test\*

#分割线
连续4个减号、星号，MarkDown会把他识别为一条分割线，如下:

----

****

#其他
MarkDown同时兼容HTML,你可以在MarkDown使用大部分html的标签例如<img>

2

赞