Markdown基础语法详细版

1 Markdown简介

       百度百科释义：Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

       由于Markdown的轻量化、易读易写特性，并且对于图片、图表、数学式都有支持，被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

2 Markdown特点

       通过简介部分相信大家应该对Markdown有了初步了解，综合来看，可以用以下四点来大致概括这一被广泛使用的语言。

• 一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。
• 于 2004 由约翰·格鲁伯（英语：John Gruber）创建。
• 编写的文档可导出 HTML 、Word、图像、PDF、Epub 等多种格式。
• 编写的文档后缀为 .md, .markdown。

3 Markdown基本语法

3.1 标题

       随着“#”号个数增加，标题级别逐级下降。其中，“#”与文字间存在一个空格。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

3.2 斜体和粗体

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

       显示效果：

• 斜体文本
• 斜体文本
• 粗体文本
• 粗体文本
• 粗斜体文本
• 粗斜体文本

3.3 换行

• 一句话后面敲两个空格。
  
• 两句话之间加一个空行。
  
• 语言分行位置输入代码<br/>。
  

3.4 分割线

***
*****
----------

       显示效果：

3.5 列表

3.5.1 无序列表

       利用使用 *，+，- 表示无序列表。

* 无序列表项 一
+ 无序列表项 二
- 无序列表项 三

       显示效果：

• 无序列表项 一
• 无序列表项 二
• 无序列表项 三

3.5.2 有序列表

       利用数字后加一个英文句点。

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

显示效果：

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

3.5.3 定义型列表

       由名词和解释组成。一行写定义，接着一行写解释。解释语句写法:紧跟一个缩进(Tab)。

Markdown
  一种轻量级标记语言
代码块 2
  代码块2的定义说明

       显示效果：

       Markdown

               一种轻量级标记语言

       代码块 2

               代码块2的定义说明

3.5.4 列表缩进

       项目标记后面则一定要接着至少一个空格或制表符。

*   Markdown是一种轻量级标记语言，创始人为[约翰·格鲁伯]（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 
*   由于Markdown的轻量化、易读易写特性，并且对于图片、图表、数学式都有支持，被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

       显示效果：

• Markdown是一种轻量级标记语言，创始人为[约翰·格鲁伯]（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
• 由于Markdown的轻量化、易读易写特性，并且对于图片、图表、数学式都有支持，被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

3.5.5 包含段落的列表

       每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。

*   Markdown是一种轻量级标记语言，创始人为[约翰·格鲁伯]（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 
    由于Markdown的轻量化、易读易写特性，并且对于图片、图表、数学式都有支持，被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

       显示效果：

• Markdown是一种轻量级标记语言，创始人为[约翰·格鲁伯]（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
  由于Markdown的轻量化、易读易写特性，并且对于图片、图表、数学式都有支持，被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

3.5.6 包含引用的列表

       “>”符号前就需要加缩进。

*   一天是什么:
    > 睁眼。
    > 闭眼。

       显示效果：

• 一天是什么:

睁眼。

闭眼。

3.5.7 包含代码区块的引用

       将代码块放入<>。

`<这是一个代码块>`

显示效果：

<这是一个代码块>

4 Markdown进阶

4.1 锚点操作

       锚点含义：页内添加超链接，即链接本文档内部的某部分元素，实现当前页面中的跳转。

跳转到[Markdown简介](#index)

       显示效果：

       跳转到Markdown简介

4.2 插入代码

4.2.1 插入行内式

`abs（）` 函数使用方法

       显示效果：

 abs（） 函数使用方法

4.2.2 缩进式多行代码

       缩进 4 个空格或是 1 个制表符。

#include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

       显示效果：

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

4.2.3 用六个`包裹多行代码

       在插入代码开始和结尾行分别加三个`符号。

```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
、、、

       显示效果：

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
、、、

4.2.4 HTML 原始码

       代码区内， & 、 < 和 > 会自动转成 HTML 实体。

<div class="footer">
   © 2004 Foo Corporation
</div>
<table>
    <tr>
        <th rowspan="2">销售冠军</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>张三</td>
        <td>李四</td>
        <td>王五</td>
    </tr>
</table>

       显示效果：

© 2004 Foo Corporation

4.3 插入链接

[百度](https://www.baidu.com)
或
<https://www.baidu.com>

       显示效果：

 百度

       或

 https://www.baidu.com

4.4 插入图片

<div align="center">
<img src="https://ucc.alicdn.com/images/user-upload-01/img_convert/af74d45eef8f36b4194bf25524f608f4.png" width="20%" >
</div>

       显示效果：

4.5 插入表格

       示例：3行4列表格（含表头）。

|  表头  |  表头  |  表头  | 表头   |
| :----: | :----: | :----: | ------ |
| 单元格 | 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 单元格 |

       显示效果：

4.6 添加脚注

       脚注具体内容自动移动到文章末尾。同时脚注后方的链接可以直接跳转回到加注的地方。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^3]:开源笔记平台，支持Markdown和笔记直接发为博文

       显示效果：

       使用 Markdown¹可以效率的书写文档, 直接转换成 HTML², 你可以使用 Leanote³ 编辑器进行书写。

4.7 LaTeX 公式

4.7.1 行内公式

正方形面积公式: $S=L^2$。

       显示效果：

       正方形面积公式: S = L 2 S=L^2S=L2。

4.7.2 整行公式

       更多公式可参考：LaTeX 公式

$$
正方形面积公式:S=L^2
$$

       显示效果：

正方形面积公式 : S = L 2 正方形面积公式:S=L^2正方形面积公式:S=L2

参考文献

1. Markdown是一种纯文本标记语言。 ↩︎
   
2. HyperText Markup Language 超文本标记语言。 ↩︎
   
3. 开源笔记平台，支持Markdown和笔记直接发为博文。 ↩︎