、

、

等标签，必须在前后加上空行与其他内容区隔开，还要求它们的标签与结尾标签不能用制表符或空格来缩进。Markdown的生成器有足够智能，不会在HTML区块标签外加上不必要的

标签。

在HTML 区 块 \color{red}{区块}区块标签间的Markdown格式语法将不会被处理，在HTML区 段 \color{red}{区段}区段标签间Markdown语法是生效的。

1. Markdown的语法

2.1 Markdown的自动符号的转换语法
HTML：有两个字符需要特殊处理：< 和 & 。< 符号用于起始标签，& 符号则用于标记HTML实体，如果你只是想要显示这些字符的原型，则必须使用实体的形式。（类似于转义字符）例如<:&It;和&:&另外© 可以写成©也可以直接输 ©

Markdown: 这三个字符自动转换，不需要人为转义。如果你使用的&字符是HTML字符实体的一部分，它会保留原状，否则它会被转换成& 。比如：你想要显示

AT&T
1
那么在Markdown中写成

AT&T ：这是Markdown的写法
AT&T ：这是HTML的正确写法，但是在Markdown中也会被自动转换
1
2
都能达到想要实现的效果。

2.2 Markdown区块元素：段落换行和缩进
一个 Markdown 段落的前后要有一个以上的空行。普通段落不该用空格或制表符来缩进。如果想在段前加缩进

 是一个中文字符  是半个中文字符  是1/4中文字符
1
普通段落也不能用回车来换行（当然如果你使用的是typora的话，可以直接回车创建新段落）

1.使用

内容

来组成封闭的一行
2.使用<br/>换行

• 当然这会对插入<br/>标签造成麻烦。如果你确实想要依赖Markdown来插入<br/>标签的话，在插入处先按入两个以上的空格然后回车。

1
2
3
2.3 Markdown标题
Markdown支持两种标题的语法，类Setext和类atx形式

类Setext形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），紧挨着显示的标题下一行输入，例如：

第一阶标题

第二阶标题显示效果有下划线

（任意数量的=和-都可以有效果）
类Atx形式则是在行首插入1到6个#，对应到标题1到6阶，例如：
2.4 Markdown标记区块引用(常用于备注说明)
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。 在每行的最前面加上 >

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ,例如：

引用

嵌套引用
效果如下：

引用

嵌套引用

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等：

这是一个标题。

1. FirstLine。
2. SecondLine。

给出一些例子代码：

return shell_exec("echo $input | $markdown_script");

1
2
3
4
5
6
7
8
效果如下:

这是一个标题。
FirstLine。
SecondLine。
给出一些例子代码：

return shell_exec("echo $input | $markdown_script");
1
Markdown也允许你偷懒只在整个段落的第一行最前面加上> :