markdown教程

markdown语法笔记

标题

使用#可以标记1-6级标题，一级标题对应一个#，二级标题对应两个#,以此类推。例：

三级标题

实例：### 这样即是三级标题

四级标题

实例：#### 这样即是四级标题

注意：#与标题之间有一个空格

---

字体

斜体 实例： *此为斜体*或者_此也可为斜体_
粗体 实例： **此为粗体**或者__此也可为粗体__
粗斜体 实例： ***同上***或者___三个下划线___

---

分割线

一行中用三个及以上的星号/减号/下划线来建立一个分隔线。以下举例均可：
***:推荐使用此格式

---

- - -:注意减号间要有空格，否则表示为二级标题

---

_ _ _

---

删除线

只需要在文字的两端加上两个波浪线~~即可，实例如下：
不要的就叉掉： ~~是两个破浪线~~

下划线

下划线需要通过HTML的 <u></u>标签来实现：
下划线不好用

---

无序列表

使用星号/加号/减号来标记，例如：

- 第一项
- 第二项
- 第三项

效果为：

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

有序列表

用序号加 . 标识即可

1. 与显示的格式相同
2. 第二项
3. 第三项

嵌套列表

只需在子列表中的选项添加四个空格即可：

1. 第一项
    - 子项
2. 第二项
    - 另一个子项

效果为：

1. 第一项
   • 子项
2. 第二项
   • 另一个子项

注意：标识符与文本间均有空格

区块

在每行的开头使用 > 标记即可合并为一个区块，同时区块可以嵌套，一行使用多个 > 即可 ,效果如下：

飞

流

直

下

代码块

如果要突出显示一个函数或代码片段，可以使用反引号`将所要突出显示的部分包起来，
如果是一个代码区块，使用多个反引号`` `````将内容包括即可。

链接

使用链接的方式如下:
[链接名称](链接地址)，效果如下：
这是一个链接：星宿长安
若想直接以一个网址作为链接，方式为 <链接地址> ，例如：https://www.baidu.com。

图片

展示图片的语法格式为：![alt 属性文本](图片地址 "可选标题")

• 开头一个感叹号
• 接着一个方括号里写图片的解释文字
• 然后是一个圆括号填入图片的地址，可以是本地路径，也可以是网络链接
• 'title’属性文字可选，鼠标悬停会显示的文字

Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用HTML的 <img> 标签。
<img src="" width="50%" ...>

表格

Markdown 制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行。如下：

|  表头  |  表头  |
| ----  | ----   |
| 单元格 | 单元格 
| 单元格 | 单元格 |

显示效果如下：

表头	表头
淦	淦淦淦淦淦
淦淦	淦淦淦淦淦淦淦淦淦淦淦淦

还可以表格的对齐方式：

• -:标题和内容右对齐
• :-标题和内容左对齐
• :-:标题和内容居中

使用方式如下：

|  左对齐  |  居中  | 右对齐 |
| :----   | :----: | ----: |
| 单元格  | 单元格 | 单元格  |
| 单元格  | 单元格 | 单元格  |

next 显示出错 | 左对齐 | 居中 | 右对齐 | | :------| :------: | ------: | | 占 | 占占占 | 占占占占占占 | | 占占占 | 占占占占占 | 占占占占占占占占占占 |

注意：

1. | - ： 之间多余的空格会被忽略，不影响布局。
2. 默认表头为居中对齐，内容为左对齐
3. 每行的第一个和最后一个 | 可以省略， - 的数量至少有一个
4. 表格语句的上下均要为空行

高级技巧

HTML标签

Markdown支持许多HTML标签，例如：
<kbd>标签:用来表示文本是从键盘上键入的，键入 Ctrl+W 增加文章浏览量
<sub>标签：定义下标文本
<sup>标签：定义上标文本

转义

MarkDown利用了很多特殊符号标识语法，但在需要输入这些符号就需要利用转义字符来控制，避免MarkDown语法解析。
MarkDown中的转义字符：\

注释

写代码时可以利用注释来进行调整，防止有需要时再敲一遍，有多种方式进行注释：

[comment]:<注释的内容>

[//]:<注释内容>

[//]: #注释内容

[^_^]:注释内容

<div style='display':none></div>标签

同样也支持html注释方法： <!--注释内容-->