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 换行

• 一句话后面敲两个空格。

• 两句话之间加一个空行。

• 语言分行位置输入代码
。

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 
    int main(void)
    {
        printf("Hello world\n");
    }

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：

#include 
int main(void)
{
    printf("Hello world\n");
}

4.2.3 用六个`包裹多行代码

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

```
#include 
int main(void)
{
    printf("Hello world\n");
}
、、、

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：

#include 
int main(void)
{
    printf("Hello world\n");
}
、、、

4.2.4 HTML 原始码

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

   © 2004 Foo Corporation



    

        
销售冠军
        
星期一
        
星期二
        
星期三
    
    

        
张三
        
李四
        
王五
    

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：

© 2004 Foo Corporation

值班人员	星期一	星期二	星期三
	李强	张明	王平

4.3 插入链接

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

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：

​ ​ ​ ​ ​ ​ ​ ​ 百度
​ ​ ​ ​ ​ ​ ​ ​ 或
​ ​ ​ ​ ​ ​ ​ ​ https://www.baidu.com

4.4 插入图片

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：

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$。

4.7.2 整行公式

​ ​ ​ ​ ​ ​ ​ ​ 更多公式可参考：LaTeX 公式

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

​ ​ ​ ​ ​ ​ ​ ​ 显示效果：
$$正方形面积公式:S=L^2$$

参考文献

---

1. Markdown是一种纯文本标记语言。 ↩︎

2. HyperText Markup Language 超文本标记语言。 ↩︎

3. 开源笔记平台，支持Markdown和笔记直接发为博文。 ↩︎