markdown语法

目录

• 一、基础语法
  • 标题
  • 段落/换行
  • 空行
  • 强调
  • 代码区块
  • 列表
  • 引用
  • 分割线
  • 删除线
  • 链接
  • 图片
  • 反义符
  • 折叠栏位
  • 隐藏代码
• 二、markdowb表格
  • 1. 极简方法
  • 2. 简单
  • 3. 原生方法
  • 4. 语法说明

---

前言：

Markdown是一种纯文本格式的标记语言。通过简单的标记语法，它可以使普通文本内容具有一定的格式。

Markdown语法主要分为如下几大部分： 标题，段落，区块引用，代码区块，强调，列表，分割线，链接，图片，反斜杠 \，符号'`'。

一、基础语法

标题

文章内容较多时，可以用标题分段，在想要设置为标题的文字前面加#来表示。
一个#是一级标题，二个#是二级标题，以此类推。可表示1-6级标题。
标准格式一般在#后跟个空格在写标题，如"# 社会"。

示例：

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

---

段落/换行

如果另起一行，只需在当前行结尾加 2 个空格
若想在段内强制换行的方式是使用两个以上空格加上回车（引用中换行省略回车）。

---

空行

 

---

强调

示例：

**粗体**
__粗体__
_斜体_

效果：

粗体
粗体
斜体

---

代码区块

通常编辑器根据代码片段适配合适的高亮方法，但你也可以用 ``` 包裹一段代码，并指定一种语言

```bash
void main()
{
    printf("Hello, Markdown.");
}
```

也可以使用 4 空格缩进，再贴上代码，实现相同的的效果

    void main()
    {
        printf("Hello, Markdown.");
    }

如你不需要代码高亮，可以用下面的方法禁用：

```nohighlight
```

注：需要和普通段落之间存在空行。

---

列表

无序列表：

- 列表文本前使用 [减号+空格]
+ 列表文本前使用 [加号+空格]
* 列表文本前使用 [星号+空格]

有序列表：

1. 列表前使用 [数字+"."+空格]
3. 我们会自动帮你添加数字
1. 不用担心数字编号，显示的时候会自动排序

列表嵌套:

1. 列出所有元素：
    - 无序列表元素 A
        1. 元素 A 的有序子列表
    - 前面加四个空格
2. 列表里的多段换行：
    前面必须加四个空格，
    这样换行，整体的格式不会乱
3. 列表里引用：

    > 前面空一行
    > 仍然需要在 > 前面加四个空格

4. 列表里代码段：

    ```
    前面四个空格，之后按代码语法 ``` 书写
    ```

        或者直接空八个，引入代码块

---

引用

普通引用：

> 引用文本前使用 [大于号+空格]
> 新起一行

引用里嵌套引用：

> 最外层引用
> > 多一个 > 嵌套一层引用
> > > 可以嵌套很多层

引用里嵌套列表：

> - 这是引用里嵌套的一个列表
> - 还可以有子列表
> * 子列表需要从 - 之后延后四个空格开始

引用里嵌套代码块：

> 同样的，在前面加四个空格形成代码块
>  
> ```
> 或者使用 ``` 形成代码块
> ```

---

分割线

分割线最常使用就是三个或以上，还可以使用-和_。例：" * * " or "- - -"、"_ _ _"
示例：

***
* * *
- - -
_ _ _

效果：

---

---

---

---

---

删除线

示例：

~~删除线~~

效果：

删除线

---

链接

示例：

[孙红雷的博客](https://www.cnblogs.com/sunhongleibibi/)

效果：

孙红雷的博客

---

图片

添加图片的形式和链接相似，只需在链接的基础上前方加一个！。


---

反义符

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 _ # * 进行避免。

\_不想这里的文本变斜体\_
\*\*不想这里的文本被加粗\*\*

---

折叠栏位

注：有的编辑器好像不支持，本节为扩展学习

示例：

<details>
<summary>这里是折叠标签</summary>
`这里写代码aaa`
`这里写代码bbb`
</details>

展示：

这里是折叠标签

`这里写代码aaa` `这里写代码bbb`

---

隐藏代码

# 语法
<!--隐藏-->

---

二、markdowb表格

1. 极简方法

name | 价格 | 数量
-|-|-
香蕉 | $1 | 5
苹果 | $1 | 6
草莓 | $1 | 7

效果：

name	价格	数量
香蕉	$1	5
苹果	$1	6
草莓	$1	7

2. 简单

name | 111 | 222 | 333 | 444
- | :-: | :-: | :-: | -:
aaa | bbb | ccc | ddd | eee| 
fff | ggg| hhh | iii | 000|

效果：

name | 111 | 222 | 333 | 444

• | :-: | :-: | :-: | -:
  aaa | bbb | ccc | ddd | eee|
  fff | ggg| hhh | iii | 000|

3. 原生方法

name | 111 | 222 | 333 | 444
:-: | :-: | :-: | :-: | :-:
aaa | bbb | ccc | ddd | eee| 
fff | ggg| hhh | iii | 000|

效果：

name	111	222	333	444
aaa	bbb	ccc	ddd	eee
fff	ggg	hhh	iii	000

4. 语法说明

简单方法虽然是稍微简单了些，但是前后因为没有格式所以第一列和最后一列没有居中，对于极简方式来说还相当繁琐。极简方式简单，但是都是左对齐。原生方式格式更美观。个人意见强迫症患者请用原生方式，其他请随意。

• |、-、:之间的多余空格会被忽略，不影响布局。
• 默认标题栏居中对齐，内容居左对齐。
• -:表示内容和标题栏居右对齐，:-表示内容和标题栏居左对齐，:-:表示内容和标题栏居中对齐。
• 内容和|之间的多余空格会被忽略，每行第一个|和最后一个|可以省略，-的数量至少有一个