转自
说明:
- 本教程基于 Markdown 语言编写,项目地址位于 Simple-Markdown-Guide。
- 本教程定位为基础教程,更加详细的用法可参考其他资料。
- 本教程中代码块内的代码为 Markdown 的语法。
- 本教程中部分语法使用的是 GitHub Flavored Markdown,GFM 语法与标准语法在不同环境中存在解析差异,本教程在使用时会加以说明。
- 推荐使用 Haroopad (Win)、MarkdownPad (Win) 和 Mou (OS X) 编辑器,部分编辑器中文效果欠佳,可通过自定义 CSS 字体解决。
基本
- Markdown 是一种用来写作的轻量级标记语言。
- 用标记语法,来代替常见的排版格式。
- 兼容 HTML 代码。
- 特殊字符自动转换,例如
<
和&
。
字体
使用星号
*
和底号_
表示<em>
标签。例如:
1
2*斜体*
_斜体_效果:
斜体
使用双星号
**
和双底号__
表示<strong>
标签。例如:
1
2**强调**
__强调__效果:
强调
换行
- 单一段落用空白行。
标题
列表
*
,-
,+
这三个符号效果都一样,这 3 个符号被称为 Markdown 列表符号。而有序列表则使用数字接着一个英文句点(数字大小并不会影响输出序列)。例如:
1
2
3
4
5
6* 第一行
* 第二行
* 第三行
6. 第四行
5. 第五行
4. 第六行效果:
- 第一行
- 第二行
- 第三行
- 第四行
- 第五行
- 第六行
引用
>
符号表示引用,可简写于第一行,也可以每一行都添加。区块的引用可以嵌套,只需要在层次数上加上同等数量的
>
符号。引用内可以使用其他 Markdown 语法,包括标题、列表、代码区块等。
例如:
1
2> 引用
> > 引用中的引用效果:
引用
引用中的引用
代码区块
`
是表示 inline 代码,4 个(空格)来表示缩进式代码段,分别对应 HTML 的
<code>
,<pre>
标签。也可以使用```
来表达围栏式代码块(GFM 语法,部分编辑器不支持),并指定他的语言类型,实现语法高亮。围栏式代码块可以大量减少缩进的使用,大规模的代码块使用非常方便。例如:
1
`sort()` 函数按升序对给定数组的值排序。
普通的缩进式代码块。
1
2
3
4
5<?php
$my_array = array('a' => 'Dog', 'b' => 'Cat');
sort($my_array);
print_r($my_array);
?>带语法高亮的围栏式代码块(GFM 语法,部分编辑器不支持)。
1
2
3
4
5
$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 语法,部分编辑器不支持)。
1
2
3
4
5
$my_array = array('a' => 'Dog', 'b' => 'Cat');
sort($my_array);
print_r($my_array);
链接
Markdown 支持两种形式的链接语法:行内式和参考式两种形式。
行内式链接,是在方括号后面接圆括号即可。
例如:1
[Google](https://www.google.com "Google")
效果:
参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记。
例如:1
2
3[Google][GOOGL]
[GOOGL]: https://www.google.com "Google"效果:
图片
Markdown 使用一种和链接很相似的语法来标记图片,只是多了一个
!
在最前面,同样也允许两种样式:行内式和参考式。目前为止,Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的
<img>
标签。行内式链接,是在方括号后面接圆括号即可。
例如:1

效果:
分隔线
使用三个以上的
*
、-
来建立一个分隔线,行内不能有其他字符。例如:
1
2
3
4* * *
***
- - -
---效果:
上文
下文
表格
Markdown 使用
|
和-
来绘制表格,:
可控制左对齐、右对齐及居中。例如:
1
2
3
4| Title | Description |
| :------ | :--------------------------------: |
| Version | 0.0.1 |
| Editor | [Melo618](mailto:[email protected]) |效果:
Title Description Version 0.0.1 Editor Melo618
特殊符号
- Markdown 利用
\
字符来转义一些在语法中有特殊意义的符号。
推荐阅读
License
Copyright © 2014-2018, Melo Chan. MIT License.