markdown语法
前言:
Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。
Markdown语法主要分为如下几大部分: 标题,段落,区块引用,代码区块,强调,列表,分割线,链接,图片,反斜杠 \,符号`
一、基础语法
标题
文章内容较多时,可以用标题分段,在想要设置为标题的文字前面加#来表示。
一个#是一级标题,二个#是二级标题,以此类推。可表示1-6级标题。
标准格式一般在#后跟个空格在写标题,如”# 社会”。
示例:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
段落/换行
如果另起一行,只需在当前行结尾加 2 个空格
若想在段内强制换行的方式是使用两个以上空格加上回车(引用中换行省略回车)。
空行
强调
示例:
**粗体**
__粗体__
_斜体_
效果:
粗体
粗体
斜体
代码区块
通常编辑器根据代码片段适配合适的高亮方法,但你也可以用(```)
包裹一段代码,并指定一种语言
#```bash
#void main()
#{
# printf("Hello, Markdown.");
#}
#```
也可以使用 4 空格缩进,再贴上代码,实现相同的的效果
void main()
{
printf("Hello, Markdown.");
}
如你不需要代码高亮,可以用下面的方法禁用:
1 | #```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. 语法说明
简单方法虽然是稍微简单了些,但是前后因为没有格式所以第一列和最后一列没有居中,对于极简方式来说还相当繁琐。极简方式简单,但是都是左对齐。原生方式格式更美观。个人意见强迫症患者请用原生方式,其他请随意。
- |、-、:之间的多余空格会被忽略,不影响布局。
- 默认标题栏居中对齐,内容居左对齐。
- -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
- 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个