Markdown语法完全指南

Markdown是一种轻量级标记语言，广泛用于文档编写、博客创作和技术文档。本文将全面介绍Markdown的语法规则，通过实例演示帮助你快速掌握Markdown写作技巧。

1. 标题（Headings）

Markdown使用#符号来定义标题，#的数量代表标题的层级，最多支持六级标题。每个#后需要添加一个空格，这是Markdown的标准语法。

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

• 示例

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 文本格式（Text Formatting）

Markdown提供了多种文本格式设置方式，包括加粗、斜体、删除线等，让文本更具表现力。

加粗

前后两个*将文字包裹起来

• 示例

**这是加粗的文字**

这是加粗的文字

斜体

前后一个*将文字包裹起来

• 示例

*这是斜体的文字*

这是斜体的文字

斜体加粗

前后三个*将文字包裹起来

• 示例

***这是斜体加粗的文字***

这是斜体加粗的文字

删除线

添加删除线

• 示例

~~这是添加删除线的文字~~

这是添加删除线的文字

3. 引用（Blockquotes）

使用>符号可以创建引用块，支持多级嵌套。引用常用于突出重要内容或引用他人观点。

不加嵌套的引用

• 示例

>引用1
>引用2
>引用3

引用1
引用2
引用3

添加嵌套的引用

• 示例

>引用1
>>引用2
>>> 引用3

引用1

引用2

引用3

4. 分割线（Horizontal Rules）

• 以下几种都可以
• 示例

---
----
***
*****

5. 图片（Images）

Markdown支持插入图片，并可以添加替代文本和标题。正确的图片格式能提升文档的可读性和SEO效果。

• 示例

![cnsre运维博客|Linux系统运维|自动化运维|云计算|运维监控](https://cdn.jsdelivr.net/gh/zops/ImagesHosting/cnsre/20210421130359.png)

6. 链接（Links）

• 示例

[SRE运维博客](https://cnsre.cn)
行内链接[SRE](https://cnsre.cn)

SRE运维博客
行内链接SRE运维博客

7. 代码（Code）

Markdown对代码的支持是其一大特色，支持行内代码和代码块，是技术文档写作的利器。

代码块

• 示例

这是`代码块`

这是代码块

单窗口代码

• 示例

```
hello SRE运维博客
```

hello SRE运维博客

多窗口代码块

• 示例
  {{< codes python shell>}}
  {{<code>}}
  ``` python
  #!/usr/bin/env python
  #coding=utf-8
  print “hello SRE运维博客”
  ```
  {{</code>}}
  {{<code>}}
  ``` shell
  #!/bin/bash
  echo “hello SRE运维博客”
  ```
  {{</code>}}
  {{</codes>}}

1
2
3

#!/usr/bin/env python
#coding=utf-8
print "hello SRE运维博客"

1
2

#!/bin/bash
echo "hello SRE运维博客"

多窗口代码2

• 示例

{{< tabs 内容1 内容2 内容3 >}}
{{< tab >}}
### 内容1
```shell
Hello SRE运维博客!
```
⚠️内容描述
{{< /tab >}}
{{< tab >}}
### 内容2
```shell
Hello SRE运维博客!
```
{{< /tab >}}
{{< tab >}}
### 内容3
```shell
Hello SRE运维博客!
```
{{< /tab >}}
{{< /tabs >}}

1

Hello SRE运维博客!

1

Hello SRE运维博客!

1

Hello SRE运维博客!

内容折叠

• 示例
  {{< expand “点击查看” >}}
  #### 标题
  内容
  {{< /expand >}}

{{< expand “点击查看 2” >}}
#### 标题2
``` shell
Hello SRE运维博客!
```
{{< /expand >}}

1

Hello SRE运维博客!

8. 列表（Lists）

无序列表

无序列表用 - + * 任何一种都可以，注意文字前加空格

• 示例

* 列表1
* 列表2
* 列表3

• 列表1
• 列表2
• 列表3

有序列表

• 示例

1. 列表1
2. 列表2
3. 列表3

1. 列表1
2. 列表2
3. 列表3

图标

文档引用libraries: "mermaid"可以用饼图

pie
"python" : 20
"shell" : 10
"go" : 70 

9. 表格（Tables）

文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右

• 示例

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

表格换行:加<br>

• 示例

表头|表头|表头
---|:--:|---:
内容|内容 <br> 内容|内容
内容|内容|内容

10. 转义字符（Escaping Characters）

用\来实现转义字符的效果

• 示例

\\ 反斜线
\` 反引号
\* 星号
\_ 底线
\{ 左花括号
\} 右花括号
\[ 左方括号
\] 右方括号

\ 反斜线
` 反引号
* 星号
_ 底线
{ 左花括号
} 右花括号
[ 左方括号
] 右方括号

11. 自动链接（Automatic Links）

自动链接只要是用尖括号包起来，就会自动被转成链接。一般网址的链接文字就和链接地址一样。
另外一种添加描述的链接示例如下，不显示链接地址

• 示例

<https://zops.github.io>
// 添加描述的链接
[Zops](https://zops.github.io "超链接title")

https://zops.github.io
添加描述的链接
Zops

12. 高级功能（Advanced Features）

• 实例

{{< notice success “这是成功的通知类型” >}}
success, info, warning, error
success text
{{< /notice >}}

成功类型通知

信息类型通知

告警类型通知

• 示例

{{< notice error “这是通知的错误类型” >}}
success, info, warning, error
success text
{{< /notice >}}

这是通知的错误类型

彩色告警文本框