markdown 常用语法 - 方便自己使用与记忆

<div id = “url”/>

1. 段落与换行

• 段落前后必须是空行，空行指的是行内什么都没有，如果中间没有空行，会显示在一行
• 换行是添加标签 <br> 或者是在行末尾加入至少两个空格
• 使用 <p> 进行标识一个段落

2. 标题

• setext 形式

=== 在下一行表示一级标题 — 在下一行表示二级标题
= 和 — 的数量是没有限制的

• atx 形式

在左边使用# 用几个表示几级标题，最多支持 6 级

3. 引用

• 使用 > 可将这行标记为引用, 效果如下

这是引用内容

这是二级引用内容

4. 列表

4.1 无序列表

前面使用 ‘*’ ‘+’ ‘-‘ 来标识，会出现黑色小圆点

4.2 有序列表

有序列表以数字和 . 开始，要和正文加空格隔开

4.3 嵌套列表

嵌套使用有序或者无序列表，可以随意嵌套

4.4 表格

使用 | 来分割不同的单元格，使用 - 来分割表头和其他行，默认居中如果想居左在中划线左边加冒号

|name  | age | gender |
|---   | :--- | --- |
|sam   | 18  | male |
|tracy | 18  | female |

name	age	gender
sam	18	male
tracy	18	female

5. 代码

可以使用三个 \` 包裹代码块，想让代码块换行 三个 \` 必须与上一行中间有一个空行，代码块才能自动换行  
行内代码可以用一个 \` 包裹代码

6. 分割线

• 在一行中使用三个或者更多的 * 或者 _ 来添加分割线 可以有空格但不能有其他的字符
• 使用 <hr> 来添加分割线

7. 超链接

• 格式为 [link text](URL 'title text')。
• 段落与换行 锚点超链接，使用 <a> <span> <div> 定义一个 id 然后[段落与换行](#url) 使用# 加 id 来定位
• 使用 <> 包裹的 url 或邮箱地址会被自动转换为超链接

8. 图片

• ![图片名称](图片地址)
• <img/> 标签包裹，src 是图片地址

9. 强调

• 使用一个 前后包裹一段文本或者下划线(_) 包裹的一段文本会被转换为斜体 效果 like this* 注意两个星号或者下划线不与文本有空格，否则不剩下
• 使用两个 或者两个下划线(__) 包裹的文本会被加粗 效果 like this**
• 使用三个 * 或者三个下划线(___) 包裹的文本或被加粗变斜体

效果 like this

• 使用两个波浪线包裹的文本会加上删除线

一、标题

1. 使用 = 和 – 标记一级和二级标题

输入标题文字，shift + enter 另起一行，输入 两个或两个以上“= / –”。

一级标题
==

二级标题
--

2. 使用 # 号标记

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

二、段落

段落的换行是使用两个以上空格加上回车。

1. 字体

* 斜体文本 *
_斜体文本_
** 粗体文本 **
__粗体文本__
*** 粗斜体文本 ***
___粗斜体文本___

2. 分割线

在一行中用三个以上的星号、减号、底线来建立一个分隔线。

***

---

___

3. 删除线

在文字的两端加上两个波浪线 ~~

~~BAIDU.COM~~

4. 下划线

可以通过 HTML 的 <u> 标签来实现

<u> 带下划线的内容 </u>

<u> 带下划线的内容 </u>

5. 脚注

脚注是对文本的补充说明

格式：[^ 要注明的文本]
例：需要注明的文本 [^MarkDown]。[^MarkDown]:Markdown 是一种轻量级标记语言。

需要注明的文本 ¹。

三、列表

MarkDown 支持有序列表 和 无序列表

1. 无序列表

无序列表使用星号 (*)、加号(+) 或是减号 (–) 作为列表标记

* 星号
+ 加号
- 减号

• 星号
• 加号
• 减号

2. 有序列表

有序列表使用数字并加上 . 号来表示

1. 第一项
2. 第二项

1. 第一项
2. 第二项

3. 列表嵌套

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

1.parent1
    +p1-child1
    +p1-child2
2.parent2
    -p2-child1
    -p2-child2

1. parent1

   • p1-child1
   • p1-child2

2. parent2

   • p2-child1
   • p2-child2

四、区块

1. 简单使用

1. 在段落开头使用 > 符号，然后后面紧跟一个 空格 符号

2. 区块是可以嵌套的

> MarkDown

>> MarkDown

MarkDown

MarkDown

2. 区块与列表结合

1. 区块中使用列表

2. 列表中使用区块

> 区块中使用列表
> 1. 有序
> + 无序
> 2. 有序
> - 无序

1. 列表中使用区块
    > 区块内容
    >> 区块内容
2. 列表中使用区块

区块中使用列表

1. 有序

• 无序

1. 有序

• 无序

1. 列表中使用区块

   区块内容

   区块内容

2. 列表中使用区块

五、代码

1. 段落中的代码

用反引号把它包起来（`）

`Markdown` 是一种轻量级标记语言。

Markdown 是一种轻量级标记语言。

2. 代码块

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

2. 用 ` 包裹一段代码，并指定一种语言（也可以不指定）

​```markdown
Markdown 是一种轻量级标记语言。​```

显示：

Markdown 是一种轻量级标记语言。

六、链接

1. 简单使用

[链接名称](链接地址)
或者
< 链接地址 >

// 例：[百度](www.baidu.com)
<www.baidu.com>

百度

<www.baidu.com>

2. 高级链接

链接也可以用变量来代替，文档末尾附带变量地址

百度[百度][1]
教育宝[教育宝][jyb]

[1]:www.baidu.con
[jyb]:https://www.jiaoyubao.cn/

百度百度
教育宝教育宝

七、图片

1. 简单使用

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

2. 使用变量

可以像网址那样对图片网址使用变量，在文档的结尾位变量赋值

LOGO JYB-logo

3. 使用 img 标签(可自定义宽高)

<img src="图片链接" width=""height="">

<img src=”https://www.jiaoyubao.cn/imag…; width=”200″ height=”110″>

八、表格

1. 简单使用

使用 | 来分隔不同的单元格，使用 – 来分隔表头和其他行

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

表头	表头
单元格	单元格
单元格	单元格

2. 对齐方式

• -: 设置内容和标题栏居右对齐。
• :- 设置内容和标题栏居左对齐。
• :-: 设置内容和标题栏居中对齐。

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

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

九、补充

1. 支持的 HTML 标签

目前支持的 HTML 元素有：<kdb> <b> <i> <em> <sup> <sub> <br>等

<kbd>Ctrl</kbd>+<kbd>C</kbd> 复制
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> QQ 截图

Ctrl+C 复制
Ctrl+Alt+A QQ 截图

2. 转义

如需显示特定的符号，使用反斜杠转义特殊字符。

** 加粗 ** 
\*\* 显示星号 \*\*

加粗
** 显示星号 **

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

---

1. Markdown 是一种轻量级标记语言。↩