markdown简明语法教程

4.5 周庆 markdown 2018-12-26

说明：

本教程基于markdown语言编写,项目地址位于Simple-markdown-Guide.
本教程定位为基础教程,更加详细的用法可参考其他资料.
本教程中代码块内的代码为markdown的语法.
本教程中部分语法使用的是Github Flavored markdown,GFM语法与标准语法在不同环境中存在解析差异,本教程在使用时会加以说明.
推荐使用Haroopad(Win),markdownPad(Win)和Mou(OS X)编辑器,部分编辑器中文效果欠佳,可通过自定义CSS字体解决.

基本

markdown是一种用来写作的轻量级标记语言.
用标记语法,来代替常见的排版格式.
兼容 HTML代码.
特殊字符自动转换,例如<和&.

字体

使用星号*和底号_表示<em>标签.

例如：
```
*斜体*
_斜体_
```
效果：

斜体
使用双星号**和双底号__表示<strong>标签.

例如：
```
**强调**
__强调__
```
效果：

强调

换行

单一段落用空白行.

标题

生成<h1>-<h6>标签,是通过在文字前面加上同等个数#符号来实现.
出于美观,也可以使用对称的闭合式标题符号.

例如：
```
### 这是标题
### 这是标题 ###
```
效果：

这是标题

列表

*,-,+这三个符号效果都一样,这3个符号被称为markdown列表符号.而有序列表则使用数字接着一个英文句点（数字大小并不会影响输出序列）.

例如：
```
* 第一行
* 第二行
* 第三行
6. 第四行
5. 第五行
4. 第六行
```
效果：
- 第一行
- 第二行
- 第三行
  1. 第四行
  2. 第五行
  3. 第六行

引用

>符号表示引用,可简写于第一行,也可以每一行都添加.
区块的引用可以嵌套,只需要在层次数上加上同等数量的>符号.
引用内可以使用其他markdown语法,包括标题,列表,代码区块等.

例如：
```
>    引用
>    >    引用中的引用
```
效果：

引用

引用中的引用

代码区块

\`是表示inline代码,4个（空格）来表示缩进式代码段,分别对应HTML的<code>,<pre>标签.也可以使用\`\`\`来表达围栏式代码块（GFM语法,部分编辑器不支持）,并指定他的语言类型,实现语法高亮.围栏式代码块可以大量减少缩进的使用,大规模的代码块使用非常方便.

例如：
```
`sort()` 函数按升序对给定数组的值排序.
```
普通的缩进式代码块.
```
    <?php
        $my_array = array('a' => 'Dog', 'b' => 'Cat');
        sort($my_array);
        print_r($my_array);
    ?>
```
带语法高亮的围栏式代码块（GFM语法,部分编辑器不支持）.
```
```php
<?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
?>
```
```
效果：

sort() 函数按升序对给定数组的值排序.

普通的缩进式代码块.
```
<?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
?>
```
带语法高亮的围栏式代码块（GFM语法,部分编辑器不支持）.
```
<?php
    $my_array = array('a' => 'Dog', 'b' => 'Cat');
    sort($my_array);
    print_r($my_array);
?>
```

链接

markdown支持两种形式的链接语法：行内式和参考式两种形式.

行内式链接,是在方括号后面接圆括号即可. 例如：
```
[Melo618](http://melo618.com "Melo618的博客")
```
效果：

Melo618

参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记. 例如：
```
[Melo618][blog]

[blog]: http://melo618.com "Melo618的博客"
```
效果：

Melo618

图片

markdown使用一种和链接很相似的语法来标记图片,只是多了一个!在最前面,同样也允许两种样式：行内式和参考式.
目前为止,markdown还没有办法指定图片的宽高,如果您需要的话,您可以使用普通的<img>标签.

行内式链接,是在方括号后面接圆括号即可. 例如：
```
![微信](http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png "微信")
```
效果：

参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记. 例如：
```
![微信][QR]

[QR]: http://7sbovo.com1.z0.glb.clouddn.com/simple-markdown-guide-weixin.png "微信"
```
效果：

分隔线

使用三个以上的*,-来建立一个分隔线,行内不能有其他字符.

例如：
```
* * *
***
- - -
---
```
效果：

上文

下文

表格

markdown使用|和-来绘制表格,:可控制左对齐,右对齐及居中.

例如：

| Title   | Description                        |
| :------ | :--------------------------------: |
| Version | 0.0.1                              |
| Editor  | [Melo618](mailto:Editor@Email.com) |

效果：

Title	Description
Version	0.0.1
Editor	Melo618

特殊符号

markdown利用\字符来转义一些在语法中有特殊意义的符号.

markdown简明语法教程

说明：

基本

字体

换行

标题

这是标题

列表

引用

代码区块

链接

图片

分隔线

表格

特殊符号

推荐阅读

类别和标签