---
layout       : post
title        : "Markdown语法简记"
subtitle     : "Hello, Future~"
date         : 2021-09-21 12:00:00
author       : "Manford Fan"
catalog      : false
header-img   : "img/post-bg-universe.jpg"
tags         :
               - Programming
               - Tools
---

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，该语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。Markdown 编写的文档可以导出 HTML、Word、图像、PDF、Epub 等多种格式的文档，其编写的文档后缀为 .md 或者 .markdown。很多静态网站的博文都是用 Markdown 来编写的，包括一些论坛或者网站的评论也支持 Markdown。

## 标题

#### 使用=和-号表示

```
一级标题
=========

二级标题
--------- 
```

#### 使用#号表示

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

## 字体

字体可以设置加粗，斜体以及删除线，三者可以搭配使用。

```
**加粗**
*斜体*
~~删除线~~
```

**加粗**

*斜体*

~~删除线~~

## 段落

使用自然的一行空格进行分隔段落，段落开头的最佳实践是顶格写，不留空白；段落与标题之间的最佳实践是留一行空行。

这是第二段，而且和其后的标题之间也留一行空行。

## 分割线

单独的三个及以上的“-”，“+”或者“\*”可以形成一条分割线，可以参考如下。

---

```
---
+++
***
```

## 列表

#### 有序列表

有序列表使用数字并加上 . 号来表示，如：

```
1. 第一项
2. 第二项
3. 第三项
```

1. 第一项
2. 第二项
3. 第三项

#### 无序列表

无序列表使用星号(\*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容：

```
* 第一项
* 第二项
* 第三项
```

* 第一项
* 第二项
* 第三项

## 区块引用

区块引用是在段落开头使用 \> 符号 ，然后后面紧跟一个空格符号：

```
> 这是一个区块引用
>
> 这是第二个区块引用
>
> 这是第三个区块引用
```

> 这是一个区块引用
>
> 这是第二个区块引用
>
> 这是第三个区块引用

## 代码

#### 代码片段

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（\`），例如：

```
`print()` 函数
```

`print()` 函数

#### 代码块

代码块用三个反引号（\`）对来把代码块包裹起来，例如：

```
\```cpp
#include <stdio.h>
uint32_t u = 0x40490fdb;
float a = *reinterpret_cast<float*>(&u);
std::cout << a;  // 3.14159
\```
```

```cpp
#include <stdio.h>
uint32_t u = 0x40490fdb;
float a = *reinterpret_cast<float*>(&u);
std::cout << a;  // 3.14159
```


## 超链接

超链接由一个方括号和一个圆括号构成，方括号是超链接的显示部分，圆括号里面放着超链接的地址。

```
这是一个链接 [网站导航](https://nav.rustle.cc)
```

这是一个链接 [网站导航](https://nav.rustle.cc)

## 脚注

脚注使您可以添加注释和参考，而不会使文档正文混乱。当您创建脚注时，带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。

```
Here's a simple footnote,[^1] and here's a longer one.[^bignote]

[^1]: This is the first footnote.

[^bignote]: Here's one with multiple paragraphs and code.

    Indent paragraphs to include them in the footnote.

    `{ my code }`

    Add as many paragraphs as you like.
```

Here's a simple footnote,[^1] and here's a longer one.[^bignote]

参考文章最后的注脚~

## 任务列表

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。

```
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
```

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

## 图片

开头是一个英文的感叹号，紧接着的方括号内的描述性文字是可选的，超链接后面还可以跟上标题属性文字。

```
![nav 图标](https://nav.rustle.cc/assets/images/favicon.png "title")
```

![nav 图标](https://nav.rustle.cc/assets/images/favicon.png "title")

## 表格

表格分为表头，对齐格式以及主体，每一列之间使用竖线分隔。

```
| left     | center     |right  |
| :------- | :-----:    |---:   |
| 左对齐   | 居中对齐   |右对齐 |
```

| left     | center     |right  |
| :------- | :-----:    |---:   |
| 左对齐   | 居中对齐   |右对齐 |


## Emoji

一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾，并包含表情符号的名称。

```
🖐去露营了！ :tent: 很快回来。

真好笑！ :joy:
```

🖐去露营了！ :tent: 很快回来。

真好笑！ :joy:

目测不支持代码转义，但是直接复制过来还是支持的~


## Finals

另外，Markdown 还可以结合 Html 使用，还有流程图等等，暂时用不到，先记录这么多，够用就好。


[^1]: This is the first footnote. And part content of this article comes from https://markdown.com.cn/

[^bignote]: Here's one with multiple paragraphs and code.

    Indent paragraphs to include them in the footnote.

    `{ my code }`

    Add as many paragraphs as you like.