Markdown使用语法详解

目录

1. 标题

2. 段落格式

3. 字体

4. 区块引用

5. 列表

6. 链接

7. 图片

8. 表格

9. 线

10. 代码块

11. HTML元素

12. 其他

多选框（清单列表）

svg支持

转义符

附：转义表 

附：HTML特殊转义字符对照表

emoji表情

---

1. 标题

使用  #号+空格 可标记1 - 6级标题，一级标题对应 1 个 # 号，二级标题对应 2 个 # 号，以此类推。

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

2. 段落格式

段内换行：段落内的换行使用 2 个以上空格加上回车；也可以在段落后面使用一个空行来表示重新开始一个段落。

注：正常段落换行用 2空格+回车；表格中换行用<br>。

这是第一段的第1行    <--末尾添加至少2个空格
这是第一段的第2行
(空行)
这是第二段
(空行)
这是第三段

3. 字体

斜体： 用 * 或者 _ 包含斜体内容；

粗体： 用 ** 或者 __ 包含加粗内容；

粗体+斜体： 用  *** 或 ___ 包含内容；

*斜体文本*
_斜体文本_

**粗体文本**
__粗体文本__

***粗斜体文本***
___粗斜体文本___

字号及颜色： font标签  + size、color 属性

<font size=6>大小为6的字体</font>

<font color=red>红色的字</font>

<font color=red size=6>红色、大小为6的字</font>

4. 区块引用

区块引用：段落开始处加上 > + 空格

区块嵌套引用：嵌套处使用多个 > + 空格

> 区块
> > 嵌套1
> > > 嵌套2

5. 列表

无序列表： 使用星号  * ，加号 + 或是减号 - 作为标记。

* 列表项1
* 列表项2

+ 列表项1
+ 列表项2

- 列表项1
- 列表项2

有序列表：使用 数字+ . 号 + 空格 来表示，注意 . 号和实际内容之间需要加一个空格。

1. 有序列表项1
2. 有序列表项2

 列表嵌套：只需要在子列表选项的前面添加 4 个空格 即可。

* 无序列表1
    1. 有序列表1.1
    2. 有序列表1.2
* 无序列表2
    - 无序列表2.1
    - 无序列表2.2

列表中插入段落： 与同列表内容保持相同缩进，格式与段落相同

* 无序列表1
    1. 有序列表1.1
    2. 有序列表1.2
* 无序列表2
    - 无序列表2.1
    - 无序列表2.2  
      段落内容1  
      段落内容2
    - 无序列表2.3

6. 链接

1. 格式： [链接名](URL)

2. 格式： [链接名](URL "title") ，增加链接Title(鼠标悬浮时显示)

3. 格式：<链接地址>

[百度一下](https://www.baidu.com)

[百度一下](https://www.baidu.com "点击打开百度首页")

<https://www.baidu.com>

其他： 搭配标题，作为同页面锚点使用 [#标题名称]  （标题名中特殊字符需去除，支持性以实测为准） 

# 标题一

# 标题二

## 小标题2.1

## 小标题2.2

## 小标题2.3


[#标题一]


[文字](#小标题22)

7. 图片

1. 语法：  

2. 拓展：使用标签调整图片的高度、宽度等参数（部分Markdown实现支持此用法，以实测为准）

![百度图标](https://www.baidu.com/favicon.ico)

<img src="https://www.baidu.com/favicon.ico" width=120%>

<img src="https://www.baidu.com/favicon.ico" width=100 height=100>

8. 表格

表格：使用 | 来分隔单元格，使用 - 来分隔表头和其它行。

对齐方式：使用 :- 设置内容和标题栏左对齐，右对齐使用 -: ，居中对齐使用 :-: 

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

---

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

9. 线

分割线：语法为连续三个以上 *** 、 --- 、 ___ ；中间可穿插空格

***
* * *
******
- - -     <-- 短横线
_ _ _     <-- 下划线

删除线：文字两端使用一个或两个 ~ 

~我有删除线~
~~我有删除线~~

下划线：使用 <u> 标签

<u>我带下划线</u>

10. 代码块

代码片段： 用 ` 包括一个词或短语

代码块：用  ``` 包含代码块，起始处可指定代码语言

段落内代码块： `System.out.println("hello world.")`



```java

System.out.println("hello world.")

```

11. HTML元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。

常用HTML标签一般格式为：  <标签名> 文本 </标签名> 

目前支持的 HTML 元素有：

换行	br	<br> </br>

加粗	b	<b>加粗</b>

斜体	i	<i>斜体<i>

下划线	u	<u>下划线</u>

删除线	del	<del>删除线</del>

加亮	mark	<mark>加亮</mark>

超链接	a属性：href	<a href='链接指向地址'>超链接</a>

文本下角	sub	文本<sub>下角</sub>

文本上角	sup	文本<sup>上角</sup>

小字体	small	<small>小字体</small>

大字体	big	<big>大字体</big>

打字机文本	tt	<tt>打字机文本</tt>

键盘文本 kbd  <kbd>键盘输入</kbd>

12. 其他

多选框（清单列表）

需搭配列表规则一起使用，未完成项使用 [空格] 表示，已完成使用 [x] 表示 

1. [X] 已完成内容, 使用字母x替换空格
2. [ ] 未完成内容1
3. [ ] 未完成内容2


- [x] 已完成内容, 不区分大小写
- [ ] 未完成内容1
- [ ] 未完成内容2

* [X] 已完成内容
* [ ] 未完成内容1
* [ ] 未完成内容2

svg支持

<svg width="100" height="100">
    <circle cx="50" cy="50" r="40" stroke="green" stroke-width="4" fill="yellow" />
</svg>

转义符

使用字符编码转义；使用转义字符串进行转义；使用 \ 转义特殊字符；

使用   表示一个空格

使用   表示一个空格

使用 \# 表示一个'#'号，而不是标题

附：转义表 

字符	十进制	转义字符
"	"	"
&	&	&
<	&#60;	&lt;
>	&#62;	&gt;
不断开空格(non-breaking space)	&#160;	&nbsp;

附：HTML特殊转义字符对照表

字符	十进制	转义字符	字符	十进制	转义字符	字符	十进制	转义字符
¡	¡	¡	Á	Á	Á	á	á	á
￠	¢	¢	Â	Â	ˆ	â	&#226	â
￡	£	£	Ã	Ã	Ã	ã	ã	ã
¤	¤	¤	Ä	Ä	&Auml	ä	ä	ä
￥	¥	¥	Å	Å	˚	å	å	å
|	¦	¦	Æ	Æ	Æ	æ	æ	æ
§	§	§	Ç	Ç	Ç	ç	ç	ç
¨	¨	¨	È	È	È	è	è	è
©	©	©	É	É	É	é	é	é
a	ª	ª	Ê	Ê	Ê	ê	ê	ê
«	«	«	Ë	Ë	Ë	ë	ë	ë
¬	¬	¬	Ì	Ì	Ì	ì	ì	ì
	­	­	Í	Í	Í	í	í	í
®	®	®	Î	Î	Î	î	î	î
ˉ	¯	¯	Ï	Ï	Ï	ï	ï	ï
°	°	°	Ð	Ð	Ð	ð	ð	&ieth;
±	±	±	Ñ	Ñ	Ñ	ñ	ñ	ñ
2	²	²	Ò	Ò	Ò	ò	ò	ò
3	³	³	Ó	Ó	Ó	ó	ó	ó
′	´	´	Ô	Ô	Ô	ô	ô	ô
μ	µ	µ	Õ	Õ	Õ	õ	õ	õ
¶	¶	¶	Ö	Ö	Ö	ö	ö	ö
·	·	·	×	×	×	÷	÷	÷
¸	¸	¸	Ø	Ø	Ø	ø	ø	ø
1	¹	¹	Ù	Ù	Ù	ù	ù	ù
o	º	º	Ú	Ú	Ú	ú	ú	ú
»	»	»	Û	Û	Û	û	û	û
¼	¼	¼	Ü	Ü	Ü	ü	ü	ü
½	½	½	Ý	Ý	Ý	ý	ý	ý
¾	¾	¾	Þ	Þ	Þ	þ	þ	þ
¿	¿	¿	ß	ß	ß	ÿ	ÿ	ÿ
À	À	À	à	à	à

emoji表情

😐😕😃😦😗😒😡

附：🤣 Emoji表情大全，颜文字百科 💌 - EmojiXD