markdown 缩进_5分钟学会Markdown基本语法

本文使用 Zhihu On VSCode 创作并发布

Markdown是一种轻量级标记语言，它以纯文本形式(易读、易写、易更改)编写文档，并最终以HTML格式发布。 Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

优点：

• 它是易读（看起来舒服）、易写（语法简单）、易更改纯文 本。处处体现着极简主义的影子。
• 兼容HTML，可以转换为HTML格式发布。
• 跨平台使用。
• 越来越多的网站支持Markdown。
• 更方便清晰地组织你的电子邮件。（Markdown-here, * Airmail）
• 摆脱Word（我不是认真的）。

缺点：

1、需要记一些语法（当然，是很简单。五分钟学会）。
2、有些平台不支持Markdown编辑模式。

注：本文的显示效果用的是TyporaMarkdown编辑软件

一、标题

在想要设置为标题的文字前面加#来表示 一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。

注：标准语法一般在#后跟个空格再写文字。

示例：

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

效果如下：

或者，在文本下方的行上，添加任意数量的==（标题级别1）或 --（标题级别2）的字符。

示例：

这是一级标题
===============

这是二级标题
---------------	

效果如下：

二、字体

• 加粗

要加粗的文字左右分别用两个*号包起来

• 斜体

要倾斜的文字左右分别用一个*号包起来

• 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

• 删除线

要加删除线的文字左右分别用两个~~号包起来

示例：

**这是加粗的文字**
*这是斜体的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果如下：

三、引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用，

示例：

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

效果如下：

四、分割线

三个或者三个以上的 - 或者 * 或者_都可以。

示例：

---
----
***
*****
___
____

效果如下：

可以看到，显示效果是一样的。

五、图片

1）插入互联网上图片

语法：

![图片描述](图片链接 ''图片title'')

图片描述就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。
注意：title可加可不加

注意：这个图片描述可以不写。

示例：

![杀生丸](https://pic4.zhimg.com/80/v2-560623bcbaa438b1627578aa70f5b08c.png)

效果如下：

杀生丸

2）插入本地图片链接

语法：

![图片描述](图片本地路径 ''图片title'')
图片描述就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。
注意：title可加可不加

注意：这个图片描述可以不写。

示例：

![犬夜叉](./image/4b9565e605bccd55f8354609dcd7ebcb.jpg)

效果如下：

犬夜叉

六、超链接

语法：

[超链接名](超链接地址 "超链接title")
注：title可加可不加

示例：

[知乎](https://www.zhihu.com/)
[百度](https://www.baidu.com/)

效果如下：

知乎
百度

七、列表

无序列表

语法：
无序列表用 - + * 任何一种都可以

- 无序列表内容
+ 无序列表内容
* 无序列表内容

注意：- + * 跟内容之间都要有一个空格

效果如下：

可以看到，显示效果是一样的。

有序列表语法：
数字加点

1. 有序列表内容
2. 有序列表内容
3. 有序列表内容

注意：序号跟内容之间要有空格

效果如下：

列表嵌套

上一级和下一级之间敲一个Tab键即可

示例一、

* 一级无序列表内容
    * 二级无序列表内容
    * 二级无序列表内容
    * 二级无序列表内容

效果如下：

示例二、

* 一级无序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

效果如下：

示例三、

1. 一级有序列表内容
    * 二级无序列表内容
    * 二级无序列表内容
    * 二级无序列表内容

效果如下：

示例四、

2. 一级有序列表内容
    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

效果如下：

八、表格

语法：

|表头|表头|表头|
|---|:--:|---:|
|内容|内容|内容|
|内容|内容|内容|

第二行分割表头和内容。
- 有一个就行，为了对齐，多加了几个
文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右

示例：

|姓名|性别|分数|
|--|:--:|--:|
|小明|男|100|
|小红|女|89|
|小飞|男|88|

效果如下：

九、代码

语法：
单行代码：代码之间分别用一个反引号包起来

   `代码内容`

代码块：
1.代码之间分别用三个反引号包起来，且两边的反引号单独占一行

(```)
  代码...
  代码...
  代码...
(```)
注：为了防止转译，前后三个反引号处加了小括号，实际是没有的。这里只是用来演示，实际中去掉两边小括号即可。

2.使用 4 个空格或者一个制表符（Tab 键）。

    代码...
    代码...
    代码...

示例：

单行代码

`print("hello world!")`

代码块 方式一、

(```)
package main

import "fmt"

func main() {
	fmt.Println("Hello, world. 你好，世界！ ")
}
(```)

方式二、

    package main

    import "fmt"

    func main() {
        fmt.Println("Hello, world. 你好，世界！ ")
    }

效果如下：

单行代码

代码块

代码块方式一与方式二显示效果是一样的

语法高亮

代码块要高亮显示，需要在前三个反引号后添加一种语言

示例：

(```)go
package main

import "fmt"

func main() {
	fmt.Println("Hello, world. 你好，世界！ ")
}
(```)

效果如下：

十、流程图

MarkDown中的流程图语法叫flow，该语法只有两个注意事项：

1. 定义元素
2. 连接定义好的元素

示例：

(```)flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
(```)

注：为了防止转译，前后三个反引号处加了小括号，实际是没有的。这里只是用来演示，实际中去掉两边小括号即可。

效果如下：

十一、换行

方法1: 连续两个以上空格+回车

示例：

Markdown是一种轻量级标记语言，它以纯文本形式(易读、易写、易更改)编写文档，  
并最终以HTML格式发布。 Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

效果如下：

方法2：使用html语言换行标签<br>：

示例：

Markdown是一种轻量级标记语言，<br>它以纯文本形式(易读、易写、易更改)编写文档，  并最终以HTML格式发布。 Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

效果如下：

十二、缩进字符

推荐使用第三种缩进方式

   缩进1/4中文
   缩进半个中文，一个字符
   缩进一个中文，2个字符

示例:

 你若安好，便是晴天。  
 你若安好，便是晴天。
 你若安好，便是晴天。

效果如下：

Reference

• https://www.jianshu.com/p/191d1e21f7ed
• https://blog.csdn.net/u014061630/article/details/81359144
• http://markdown.p2hp.com/basic-syntax/