的Markdown语法用着很舒服,总结一下Markdown语法吧。
为什么要学习Markdown语法?
Markdown 无处不在。StackOverflow、CSDN、掘金、、GitBook、有道云笔记、V2EX、光谷社区等。主流的代码托管平台,如 GitHub、GitLab、BitBucket、Coding、Gitee 等等,都支持 Markdown 语法,很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。
Markdown 标题语法
语法描述:“#” + 标题文字
# 标题文字 // 一级标题
## 标题文字 // 二级标题
### 标题文字 // 三级标题
#### 标题文字 // 四级标题
##### 标题文字 // 五级标题
###### 标题文字 // 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
注:不同的Markdown应用程序处理 # 和标题文字之间的空格方式不一致。为了兼容考虑,建议使用一个空格在# 和标题之间
Markdown 段落语法
语法描述:使用空白行将一行或者多行文本进行分隔。
注:不要使用空格(spaces)或者制表符(tabs)缩进段落。
Markdown 换行语法
语法描述:在一行的末尾添加一个或者多个空格,然后按下回车键,即可创建一个换行。
注:几乎每个 Markdown 应用程序都支持两个或多个空格进行换行,称为 结尾空格(trailing whitespace) 的方式,但这是有争议的,因为很难在编辑器中直接看到空格,并且很多人在每个句子后面都会有意或无意地添加两个空格。由于这个原因,你可能要使用除结尾空格以外的其它方式来换行。幸运的是,几乎每个 Markdown 应用程序都支持另一种换行方式:HTML 的
标签。
为了兼容性,请在行尾添加“结尾空格”或 HTML 的
标签来实现换行。
还有两种其他方式我并不推荐使用。CommonMark 和其它几种轻量级标记语言支持在行尾添加反斜杠 () 的方式实现换行,但是并非所有 Markdown 应用程序都支持此种方式,因此从兼容性的角度来看,不推荐使用。并且至少有两种轻量级标记语言支持无须在行尾添加任何内容,只须键入回车键(return)即可实现换行。
Markdown 强调语法(粗体和斜体)
粗体 语法描述:要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。
斜体 语法描述:要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。
**粗体** __粗体__
*斜体* _斜体_
效果:
粗体 粗体
斜体 斜体
注:Markdown 应用程序在处理单词或短语中间添加的下划线上并不一致。为了实现兼容性,请使用星号将单词或短语的中间部分加粗并以斜体显示,以示重要。
Markdown 引用语法
语法描述:要创建块引用,请在段落前添加一个 > 符号。
> 引用文字
效果:
引用文字
多段落的块引用
// 方法一:中间用空段落,使段落解析连续
> 吧啦吧啦吧啦
>
> 吧啦吧啦吧啦
// 方法二:使用换行符,不换段落
> 吧啦吧啦吧啦
吧啦吧啦吧啦
效果(方法一):
吧啦吧啦吧啦
吧啦吧啦吧啦
嵌套块引用
语法描述:块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
> 吧啦吧啦吧啦.
>> 吧啦吧啦吧啦.
效果:
吧啦吧啦吧啦.
吧啦吧啦吧啦.
Markdown 列表语法
有序列表 语法描述:要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
无序列表 语法描述:要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
有序列表:
1. First item
2. Second item
3. Third item
嵌套
1. First item
2. Second item
3. Third item
1. First item
2. Second item
4. Fourth item
效果:
- First item
- Second item
- Third item
嵌套:
- First item
- Second item
- Third item
- First item
- Second item
- Fourth item
无序列表
- First item
- Second item
- Third item
* First item
* Second item
* Third item
+ First item
+ Second item
+ Third item
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
效果:
- First item
- Second item
- Third item
- First item
- Second item
- Third item
- First item
- Second item
- Third item
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
Markdown 代码块语法
语法描述:要将单词或短语表示为代码,请将其包裹在反引号 (```code block``` ) 中。
```code block```
效果:
{
"name": "Eric",
"age": "25"
}
指定代码的语言:在第一个 (```) 后面添加语言名称,并换行。
```javascript
javascript code block
```
效果:
function(arg1, arg2, ...arg3){
console.log(arg1);
console.log(arg2);
console.log(arg3);
}
-
问题来了:如果在代码块中使用 ```,如上面的示例
用四个反引号(`)嵌入三个(`)
Markdown 连接语法:
语法描述:[标题](链接地址)
效果:
必应搜索
Markdown 图面语法:
语法描述:![图片描述](图片链接地址)
除了这些这些常用的以外,还有 表格、使用 Emoji 表情、任务列表等,自行百度