Markdown基本语法入门指南
Markdown的目标是实现【易读易写】。它兼容HTML ,它的语法目标是:成为一种适用于网络的书写语言。
特殊字符自动转换
在HTML文件中,有两个字符需要特殊处理:< 和 &。<符号用于起始标签,&符号则用于标记HTML实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是<+;和&+;。
标题
Markdown支持两种标题的语法,类 Setext 和 atx形式。
其中Setext是用 底线来做标记的 利用=(最高阶标题)和-(第二阶标题),
例如
This is an H1
===============
This is an H1
This is an H2
--------------
This is an H2
Ps:任何数量的= 和-都可以有效果
类Atx 是在行首插入 1 到 6 个#,对应到标题1 到 6阶,
例如
# 这是 H1
## 这是 H2
###### 这是H6
这是 H1
这是 H2
这是H6
区块引用Blockquotes :
引用的区块内也可以使用其他的Markdown语法,包括标题、列表、代码区块等:
>##这是一个标题
>
>1. 这是第一行列表项。
>2. 这是第二行列表项。
>
>给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");
这是一个标题
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
- Red
- Green
- Blue
有序列表 使用数字接着一个英文句点:
1. Bird
2. Math
3. Yellow
很重要的一点是,你在列表标记上使用的数字并不会影响输出的HTML结果,上面的列表所产生的HTML 标记为:
<ol>
<li>Bird</li>
<li>Math</li>
<li>Yellow</li>
</ol>
即使你写成
1. Bird
1. Math
1.Yellow
也不影响HTML的输出
- Bird
- Math
- Yellow
网友评论