概述

1、兼容HTML

HTML是一种发布的格式，Markdown是一种发布的格式。Markdown 语法在 HTML 区段标签间是有效的。

Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的

标签。

例：
这是一个普通段落。

<table>

<tr>

<td>1</td>

</tr>

</table>

这是另一个普通段落。

1.1表格

---

（作者：热心市民123
链接：https://www.jianshu.com/p/59aaa82ae723
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。）

---

表格前一定要空一行
在每个单元格文字的两端加上一个竖线“|”。
第二行控制单元格文本的位置，第二行控制文本的位置，规则如下：默认是靠左，用英文冒号“:”来调整，两边都有冒号，而且冒号中间至少有一个减号“-”的时候表示居中（当然也可以通过增加“-”号的数目来使它们对齐，更好看一点，但效果是一样的）；冒号在右边而且冒号之前至少有一个-的时候表示靠右，其它情况则是靠左。注意，冒号“:”一定要为英文的，不可为中文的冒号。如：

第一季度	第二季度	第三季度	第四季度
20%	30%	25%	40%

2、特殊字符自动转换

在 HTML 文件中，有两个字符需要特殊处理： < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式，像是 ＆lt和 &amp。

注意：code 范围内，不论是行内还是区块， < 和 & 两个符号都一定会被转换成 HTML 实体，这项特性让你可以很容易地用 Markdown 写 HTML code ；而HTML 语法中，要把所有的 < 和 & 都转换为 HTML 实体，才能在 HTML 文件里面写出 HTML code。

二、区块元素

1.段落和段行

2.标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。

类 Setext ：是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题）

例：This is an H1

=============

This is an H2

---

类 atx ：在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶

例：
这是 H1 #

这是 H2 ##

这是 H3 ######

3.区块引用

在每行的最前面加上 > ；在整个段落的第一行最前面加上 > ；区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ；引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等；

例：

这是一个标题。

1. 这是第一行列表项。

2. 这是第二行列表项。

给出一些例子代码：

return shell_exec("echo markdown_script");

4.列表

无序列表：使用星号、加号或是减号作为列表标记

有序列表：使用数字接着一个英文句点（数字的正确性不用在意）

例：

1. 好

2. 哈

注意：列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符：；列表要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符

5.代码区块

缩进 4 个空格或是 1 个制表符；一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

6.分割线

在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。也可以在星号或是减号中间插入空格：

---

---

---

---

---

三、区段元素

1.链接

链接文字都是用 [方括号] 来标记。

链接内容定义的形式为：

方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字

接着一个冒号

接着一个以上的空格或制表符

接着链接的网址

选择性地接着 title 内容，可以用单引号、双引号或是括弧包着

2.强调

Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 标签包围，用两个 * 或 _ 包起来的话，则会被转成<strong>

例：

single asterisks

single underscores

double asterisks

double underscores

会转成：

single asterisks

single underscores

double asterisks

double underscores

注意：*和_两边不能都有空白，否则会被当作普通符号

3.代码

标记一小段行内代码，可以用反引号把它包起来（`）

4.图片

行内式：

[图片上传失败...(image-94cbbd-1535548389219)]

[图片上传失败...(image-4ccdee-1535548389219)]

详细叙述如下：

一个惊叹号 !

接着一个方括号，里面放上图片的替代文字

接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

参考式：

Alt text

「id」是图片参考的名称，图片参考的定义方式则和连结参考一样：

四、补充

1.反斜杠

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\ 反斜线

` 反引号

• 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

井字号

• 加号

• 减号

. 英文句点

! 惊叹号

2.自动链接

支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接。

五、Markdown 免费编辑器

1.Windows 平台

Markdownpad

Markpad

2.Linux 平台

Retext

Mac 平台

Mou

3.在线编辑器

Markable.in

Dillinger.io

4.浏览器插件

MaDe(Chrome)