前言:

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

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

一、基础语法

标题

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

示例

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

段落/换行

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


空行

 

强调

示例

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

效果

粗体
粗体
斜体


代码区块

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

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

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

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

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

1
2
3
#```nohighlight
#
#```

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


列表

无序列表

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

有序列表

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

列表嵌套:

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

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

4. 列表里代码段:
    
    前面四个空格,之后按代码语法 ``` 书写
    或者直接空八个,引入代码块  

引用

普通引用

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

引用里嵌套引用

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

引用里嵌套列表

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

分割线

分割线最常使用就是三个或以上,还可以使用-和_。例:” * * “ or “- - -“、”_ _ _”
示例

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

效果






删除线

示例

~~删除线~~

效果

删除线


文字超链接

示例

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

效果

孙红雷的博客


图片展示

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

![自定义名称](imageurl)

图片超链接:

示例

1
[![alt text](http://path/to/img.jpg "title")](你的链接地址)

反义符

如果你的描述中需要用到 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. 语法说明

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

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