Markdown语法

1.2 Markdown的优点：

1.专注你的文字内容而不是排版样式

2.轻松的导出HTML、PDF和本身的.md文件

3.纯文本内容，兼容所有的文本编辑器与字处理软件

4.可读，直观。适合所有人的写作语言

1.3 Markdown兼容HTML

HTML是一种发布的格式，Markdown是一种书写的格式。Markdown的格式语法只涵盖纯文本可以涵盖的范围，不在Markdown涵盖范围之内的标签，都可以直接在文档里面用HTML撰写。不需要额外标注这是HTML或是Markdown;只要直接加标签就可以了。

要制约的只有一些HTML区块元素——比如

、

、      

等标签，必须在前后加上空行与其他内容区隔开，还要求它们的标签与结尾标签不能用制表符或空格来缩进。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中也会被自动转换

2

都能达到想要实现的效果。

2.2 Markdown区块元素：段落换行和缩进

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

 是一个中文字符  是半个中文字符  是1/4中文字符

普通段落也不能用回车来换行（当然如果你使用的是typora的话，可以直接回车创建新段落）

1.使用

内容

来组成封闭的一行

2.使用<br/>换行

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

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");           

4

5

6

7

8

效果如下:

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

Markdown也允许你偷懒只在整个段落的第一行最前面加上> :