# Markdown 语言简介

Markdown 是一种轻量级的标记型语言。Markdown 语言可以结合简化的文本标记，进行纯文本格式的文档编写。发布时 Markdown 语言引擎会根据标记将文本解析成网页元素并进行排版美化等，大大简化了文本创作外的工作量，让作者更专注于内容。以下介绍一些 Markdown 中常用的文本标记的语法和注意事项。

# 标题

文章中的标题使用 # 符号进行标记，如下图，注意 # 与标题的文本之间需要添加一个空格。 # 的个数对应着标题的级别，Markdown 语法中最多支持六级标题，级别越高的标题字号越小。

# 列表

要点、说明、步骤等需要列举的内容，可以采用列表标签进行标记。并列关系的要点等可以使用无序列表标签，而流程、步骤等顺序结构的内容，使用有序列表标记。

无序列表使用 - 、 * 、 + 作为标记符号，三种符号的标记效果相同。另外，次级项需要在标记前加 4 个空格或者一个 Tab制表符 递进。

有序列表每项的标记符号使用数字序号和 . 符号，如 1. 、 2. 等等，Markdown 语言引擎通常不支持有序列表的次级项。

- **无序列表：**

- 第一项

    - 次第一项

    - 次第二项

- 第二项 

- 第三项

**有序列表：**

1. 第一项

2. 第二项

无序列表：

• 第一项
  • 次第一项
  • 次第二项
• 第二项
• 第三项

有序列表：

1. 第一项
2. 第二项

# 字体

Markdown 语言也可以标注使用特殊字体：

* 斜体 * 或者 _斜体_

** 粗体 **

*** 加粗斜体 ***

~~ 删除线～～

下划线

背景高亮

# 超链接

Markdown 文本中直接输入网址将自动转换成链接的形式，如 www.baidu.com。

如果网址较长或者不想直接显示网址，引用格式可以让文本更加简介，格式为 [alt](url "title") ，其中 alt 是替代网址显示的文本， url 是网址链接，鼠标悬停链接上时则显示 title 属性的文本。其中， alt 和 url 是必须配置的属性， title 属性则默认为空，可不配置，即悬停时无显示，但是配置 title 属性时则不可省略双引号。

直接输入网址：www.baidu.com

使用[alt](url "title")格式：[百度](www.baidu.com "百度")

引用效果：
直接输入网址：www.baidu.com
使用 [alt](url "title") 格式： 百度

前面两种办法依然会在正文中插入网址，如果过多过长也会影响创作时的内容观感，此时则可以使用网址脚注的形式，将多个网址罗列在同一处如文章底部，正文中引用脚注即可，而且脚注内容并不会在网页内容上显示。

脚注的格式为： [alt]:url "title" ， alt 为脚注名， url 和 title 属性同上。

正文中引用格式为： [站名][脚注名] ， 站名 是在正文中显示的站点名称， 脚注名 即是脚注的 alt 属性。

脚注示例：

脚注引用：[百度][百度]、[Github][Github]

[百度]:www.baidu.com "百度"

[Github]:www.github.com "Github"

脚注引用：百度，Github

# 图片

Markdown 文本插入图片时通常引用图片的网络地址，虽然本地也可通过文件路径的方式引用本地图片，但是线上部署后的图片路径与本地路径容易冲突，导致本地或者线上无法正常加载图片，所以进行 Markdown 文本创作时一般还是会结合网络图床进行站点文章图片的管理。

图片的引用格式类似超链接：

![alt](url "title")

此时 alt 属性是图片加载失败时替代图片显示的文本内容， url 属性为图片的 网络地址 或者 文件路径 ， title 属性是鼠标悬浮在图片上时显示的文本内容。

# 表格

表格是常用的数据格式，在 Markdown 语法中，表格分为 列名 、 分割线 和 单元格 三部分：第一行为表格各列的列名；第二行为分割线，表格中的文本对齐格式也在此处配置，第二行即分割线不会在表格内容中显示；之后各行则是数据单元格。

需要注意的是，每列之间以 | 分隔，而且第二行的分割线固定为 ---- ，控制每列文本对齐的方式是分割线的左右两端是否添加英文冒号 : ，冒号 : 在分割线左侧即是左对齐，在右侧为右对齐，两端都有时，则为居中对齐。

表格示例：

| 左对齐 | 右对齐 | 居中对齐 |

| :---- | ----: | :----: |

| 数据 | 数据 | 数据 |

| 数据 | 数据 | 数据 |

效果：

另外，表格各行之间不能插入注释，否则会破坏表格格式，无法正常显示。

# 代码块

首尾使用一组反引号 ``` 可以标记代码块，结合 PrimeJS 插件，可以实现各种语言的高亮显示。

连续四个空格 或者一个 Tab制表符 也可以标记代码块，不过用反引号的形式可以更直观地确定代码块的首尾区域。

#include <stdio.h>

int main(int argc, char *argv[]) {

    printf("Hello C World!");

    return 0; 

}

# 分割线

在一空行内输入连续三个或三个以上的 * 、 - 或者 _ 符号，即可在此行位置画出一条分割线，注意行内不能有注释等其他内容。

下方是一条分割线：

# 引用

创作时，有时候需要引用名人名言、名著佳句等，在 Markdown 中，使用 > 符号标记引用，并支持嵌套， > 符号的个数即是此处引用的嵌套层数。

> 生如夏花之绚烂，死如秋叶之静美。

引用效果：

生如夏花之绚烂，死如秋叶之静美。

# 文本强调

文本前后添加 `，可以将被包含的文本强调显示，不过强调显示时， ]{.kbd}和[` 和 ``` 在默认语法中会因为符号配对无法正常输出，需要其他方式实现强调的效果。

# 特殊字符

因为 Markdown 语言使用了一些特殊字符作为标记，所以某些字符无法直接输出显示，往往需要添加 / 符号转义，若在文本中输入其字符实体，也可以直接输出。