说明:
- 本教程基于Markdown语言编写。
- 本教程定位为基础教程,更加详细的用法可参考其他资料。
- 例子中方框内的代码为Markdown的语法。
- 推荐使用Haroopad(Win)和Mou(OS X)编辑器,部分编辑器中文效果欠佳,可通过自定义CSS字体解决。
- Markdown是一种用来写作的轻量级标记语言。
- 用标记语法,来代替常见的排版格式。
- 兼容 HTML代码。
- 特殊字符自动转换,例如
<
和&
。
-
使用星号
*
和底号_
表示<em>
标签。例如:
*斜体* _斜体_
效果:
斜体
-
使用双星号
**
和双底号__
表示<strong>
标签。例如:
**强调** __强调__
效果:
强调
- 单一段落用空白行。
- 换行是连续2个空格。
-
生成
<h1>
-<h6>
,是通过在文字前面加上1-6个#
符号来实现。 -
出于美观,可以使用对称的闭合式标题符号。
例如:
## 这是标题 ## 这是标题 ##
效果:
-
*
,-
,+
这三个符号效果都一样,这3个符号被称为Markdown符号。而有序列表则使用数字接着一个英文句点(数字大小并不会影响输出序列)。例如:
* 第一行 * 第二行 * 第三行 6. 第四行 5. 第五行 4. 第六行
效果:
- 第一行
- 第二行
- 第三行
- 第一行
- 第二行
- 第三行
-
>
符号表示引用,可简写于第一行,也可以每一行都添加。 -
区块的引用可以嵌套,只需要在层次数上加上同等数量的
>
符号。 -
引用中可以使用其他Markdown语法,包括标题、列表、代码区块等。
例如:
> 引用 > > 引用中的引用
效果(本例本身处于引用效果中):
引用
引用中的引用
-
`是表示inline代码,tab是用来标记代码段,分别对应HTML的
<code>
,<pre>
标签。例如:
`sort()` 函数按升序对给定数组的值排序。 <?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); ?>
-
Markdown支持两种形式的链接语法:行内式和参考式两种形式。
行内式链接,是在方括号后面接圆括号即可。 例如:
[Melo618](http://melo618.com "Melo618的博客")
效果:
参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记。 例如:
[Melo618][blog] [blog]: http://melo618.com "Melo618的博客"
效果:
-
Markdown使用一种和链接很相似的语法来标记图片,只是多了一个
!
在最前面,同样也允许两种样式:行内式和参考式。 -
目前为止,Markdown还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的
<img>
标签。行内式链接,是在方括号后面接圆括号即可。 例如:
![微信](http://melo618.com/resources/images/my-weixin.png "微信")
效果:
参考式链接,是在链接文字的括号后面加上另一个方括号,在第二个方括号里面要填入用以辨识链接的标记。 例如:
![微信][QR] [QR]: http://melo618.com/resources/images/my-weixin.png "微信"
效果:
-
使用三个以上的
*
、-
来建立一个分隔线,行内不能有其他字符。例如:
* * * *** - - - ---
效果:
-
Markdown使用
|
和-
来绘制表格,:
可控制左对齐、右对齐及居中。例如:
| Title | Description | | :------ | :-------------------------------: | | Version | 0.0.1 | | Editor | [EDITOR](mailto:EDITOR@Email.com) |
效果:
Title Description Version 0.0.1 Editor EDITOR
- Markdown利用
\
字符来转义一些在语法中有特殊意义的符号。