markdown学习

什么是MarkDown

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

Markdown 的基本语法

Markdown 标题

使用#号可表示1-6级标题，一级标题对应一个#号，二级标题对应两个#号，以此类推。

1
2
3
4
5
6
7
8
9
10
11
# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

字体

斜体文本：可以在需要标注为斜体文本前及斜体文本结尾，输入一个星号或者一个下划线_

粗体文本：可以在需要标注为粗体文本前及粗体文本结尾，输入两个星号或者两个下划线__

粗斜体文本：可以在需要标注为粗斜体文本前及粗斜体文本结尾，输入三个星号或者三个下划线___

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

分隔线

在一行中用三个（以上）的星号、减号、底线来建立一个分隔线，该分隔线行内不能输出任何其他文本，也可以在星号或是减号中间插入空格。

1
2
3
4
***
* * *
*****
- - -

删除线

如果段落上的文字需添加删除线，在需要添加删除线的文字首部和尾部加上两个波浪线~~即可

1
~~这行文字已被删除~~

这行文字已被删除

下划线

如果段落上的文字需添加下划线，在需要添加下划线的文字首部和尾部加上文本即可

1
<u>这行文字已被添加下划线</u>

这行文字已被添加下划线

脚注

脚注是对文本的备注说明。
print ^Hello World
[^Hello World]:你好，世界

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记；

有序列表使用数字并加上 . 号标记；

1
2
3
4
5
6
* 第一
+ 第二
- 第三
1. 第四
2. 第五
3. 第六

列表嵌套

列表嵌套需在子列表中的选项中添加四个空格

  1. 第一
  • 第一个列表嵌套
  1. 第二
  • 第二个列表嵌套
1
2
3
4
5
1. 第一
 - 第一个列表嵌套
2. 第二
 - 第二个列表嵌套

引用

Markdown 引用需在段落开头使用>符号，后面紧跟一个空格符号，不加也可。

1
2
> 这是一个引用

这是一个引用

除上述引用外，还可以嵌套，一个>符号在第一层，两个>符号是第一层的嵌套，以此类推。

1
2
3
> 这是一个引用
>> 这是一个引用
>>> 这是一个引用

这是一个引用

这是一个引用

这是一个引用

引用中使用列表

1
2
3
4
> 引用列表
> - 这是一个引用
> * 这是一个引用
> 这是一个引用

引用列表

  • 这是一个引用
  • 这是一个引用
  1. 这是一个引用

代码

markdown对代码块的语法是开始和结束行都要添加：，其中 ` 为windows键盘左上角那个，要精确指定语言（如：java、cpp、css、xml、javascript、python、php、go、kotlin、lua、objectivec等等）时，在头部直接指定，如：java

1
2
3
4
5
public class HelloWorld {  
    public static void main(String[] args) {  
        System.out.println("Hello, World!");  
    }  
}

链接语法格式：

1
2
3
[链接名称](链接地址)
或者
<链接地址>

你将浪费人生中的6分钟看小鸟吵架

图片

图片语法格式：

1
2
![图片描述](图片地址)
![图片描述](图片地址 "可选标题")

表格

制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行。
表格语法格式：

1
2
3
4
|  表头   | 表头  |  表头  |
|  ----  | ----  | ----- |
| 单元格  | 单元格 | 单元格 |
| 单元格  | 单元格 | 单元格 |

|  表头   | 表头  |  表头  |
|  —-  | —-  | —– |
| 单元格  | 单元格 | 单元格 |
| 单元格  | 单元格 | 单元格 |

科学公式

当需要在 Markdown 编辑器中插入数学公式时，可以使用两个美元符$$包裹TeX或LaTeX格式的数学公式来实现。

1
2
$$E=mc^2$$
$$\sin(\alpha)^{\theta}=\sum_{i=0}^{n}(x^i + \cos(f))$$

$$E=mc^2$$
$$\sin(\alpha)^{\theta}=\sum_{i=0}^{n}(x^i + \cos(f))$$