markdown简明语法教程
说明:
- 本教程基于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. 第六行效果: - 第一行
- 第二行
- 第三行
        - 第四行
- 第五行
- 第六行
 
 
引用
- >符号表示引用,可简写于第一行,也可以每一行都添加.
- 区块的引用可以嵌套,只需要在层次数上加上同等数量的>符号.
- 
    引用内可以使用其他markdown语法,包括标题、列表、代码区块等. 例如: > 引用 > > 引用中的引用效果: 引用 引用中的引用 
代码区块
- 
    \`是表示inline代码,4个<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][blog] [blog]: http://melo618.com "Melo618的博客"效果: 
图片
- markdown使用一种和链接很相似的语法来标记图片,只是多了一个!在最前面,同样也允许两种样式:行内式和参考式.
- 
    目前为止,markdown还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>标签.行内式链接,是在方括号后面接圆括号即可. 例如: 效果:  参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记. 例如: ![微信][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利用\字符来转义一些在语法中有特殊意义的符号.