¶ 什么是Markdown
Note: 知识收集自互联网。
Note: Markdown 是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。操作简单且可以让作者摆脱排版的困扰，专心写作。
标题 Markdown标题用法。- 段落 Markdown段落用法。
- 分割线 Markdown分割线用法。
- 字体 Markdown文字字体用法。
- 块和引用 Markdown分块和引用用法。
- 列表 Markdown无序列表和有序列表用法。
- 链接 Markdown超链接和脚注用法。
- 图片 Markdown图片用法。
- 表格 Markdown表格用法。
- 目录 Markdown目录用法。
- emoji表情符号 Markdown插入emoji表情符号用法。
- 支持的HTML元素 Markdown支持的HTML元素。
- 字符转义 Markdown中字符转义。
- 插入Mermaid流程图 在Markdown中插入Mermaid流程图。
- Markdown插入甘特图 在Markdown中插入甘特图。
- 插入LaTeX公式 在Markdown插入LaTeX公式。
¶ 标题
Markdown中标题的表示方法有两种：
- 使用
#表示标题，其中#号必须在行首，与后面标题文字之间用空格相隔，可支持六级标题； - 使用
===或者---分别表示一级标题和二级标题，只能支持一级标题和二级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
一级标题
===
二级标题
---
¶ 段落
段落的前后要有空行，所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车（区块引用中换行省略回车）。
hello world3
hello world4
hello world3
hello world4
也可以使用HTML换行标记<br />。
hello world3<br>hello world4
hello world3
hello world4
¶ 分割线
使用三个或以上的 - 或者 * 表示，且这一行只有符号，注意不要被识别为二级标题即可(符号行上一行留一行空行即可)，例如中间或者前面可以加空格
123
---
456
***
text
123
456
text
¶ 字体
¶ 斜体
要倾斜的文字左右分别用一个*或_包起来。
这是个*倾斜的文字*
这是个倾斜的文字
¶ 加粗
要加粗的文字左右分别用两个*号包起来
这是个**加粗的文字**
这是个加粗的文字
¶ 加粗斜体
要倾斜和加粗的文字左右分别用三个*号包起来
这是个***加粗斜体的文字***
这是个加粗斜体的文字
¶ 删除线
要加删除线的文字左右分别用两个~~号包起来
这是被~~删除的文字~~
这是被
删除的文字
¶ 下划线
markdown本不支持下划线，但下划线可以通过HTML的标签来实现
<u>带下划线文本</u>
带下划线文本
¶ 字体、字号与颜色
Markdown是一种可以使用普通文本编辑器编写的标记语言，通过类似HTML的标记语法，它可以使普通文本内容具有一定的格式。但是它本身是不支持修改字体、字号与颜色等功能的！
<div style="font-family: fantasy;">
<span style="color:green;font-size: x-large;">Markdown</span> is a <span style="font-style: italic;">lightweight markup language</span>.
</div>
实例：
Markdown is a lightweight markup language.
¶ 背景色
Markdown本身不支持背景色设置，需要采用内置html的方式实现：可借助 div等html标记的background, table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能。
<div style="background: yellow; color: red;">背景色黄色</div>
<table border="1">
<tr>
<th bgcolor="#ff0000">Month</th>
<th bgcolor="yellow">Savings</th>
</tr>
<tr>
<td>January</td>
<td bgcolor="rgb(53,207,192)">$100</td>
</tr>
</table>
实例：
背景色黄色
Month Savings January $100
¶ 块
¶ 引用
在引用的文字前加>即可。引用可以嵌套，如加两个>>、三个>>>、n个>>>...
>这是引用的内容1
>>这是引用的内容2
>>>>这是引用的内容3
这是引用的内容1
这是引用的内容2
这是引用的内容3
> 这是第一级引用
> > 这是第二级引用
>
> 现在回到第一级引用
> **引用里也可以使用Markdown语法**
这是第一级引用
这是第二级引用
现在回到第一级引用
引用里也可以使用Markdown语法
¶ 代码块
对于程序员来说这个功能是必不可少的，插入程序代码的方式有两种，一种是利用缩进(tab), 另一种是利用英文"`"符号（一般在ESC键下方，和~同一个键）包裹代码。
- 代码块：缩进 4 个空格或是 1 个制表符。效果如下：
function myFunction(p1, p2) {
return p1 * p2; // 该函数返回 p1 和 p2 的乘积
}
function myFunction(p1, p2) {
return p1 * p2; // 该函数返回 p1 和 p2 的乘积
}
（2）行内式：如果在一个行内需要引用代码，只要用反引号引起来就好（一般在ESC键下方，和~同一个键）
物理学公式：功率P(w) `P= W/t`; 其中： W：功 ;t：时间
物理学公式：功率P(w)
P= W/t; 其中： W：功 ;t：时间
（3）多行代码块与语法高亮：在需要高亮的代码块的前一行及后一行使用三个单反引号“`”包裹就可以了,开头三个单反引号后可注明代码类型名。
``` js
function myFunction(p1, p2) {
return p1 * p2; // 该函数返回 p1 和 p2 的乘积
}
```
function myFunction(p1, p2) {
return p1 * p2; // 该函数返回 p1 和 p2 的乘积
}
¶ 列表
列表又分为有序列表和无序列表，列表可以嵌套。
¶ 无序列表
无序列表用 - + * 任何一种都可以，符号后面留一个空格。
- 列表项
+ 列表项
* 列表项
- 列表项
- 列表项
- 列表项
¶ 有序列表
使用数字和一个英文句点表示有序列表。点符号后面留一个空格。
1. 列表项
2. 列表项
3. 列表项
- 列表项
- 列表项
- 列表项
¶ 嵌套列表
无序列表和有序列表都可以嵌套。
- 列表项
+ 列表项
+ 子列表项
+ 子列表项
+ 子列表项
* 列表项
- 列表项
- 列表项
- 子列表项
- 子列表项
- 子列表项
- 列表项
1. 列表项
2. 列表项
1. 子列表项
2. 子列表项
3. 子列表项
3. 列表项
- 列表项
- 列表项
- 子列表项
- 子列表项
- 子列表项
- 列表项
1. 第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
- 第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
列表不光可以单独使用，也可以使用其他的 Markdown 语法，包括标题、引用、代码区块等。
注意事项：
（1）加粗效果不能直接用于列表标题里面，但是可以嵌套在列表里面混合使用。
（2）列表中包含代码块（前面加2个tab或者8个空格，并且需要空一行，否则不显示）。
¶ 任务完成（待办事项）状态
不是所有的markdown编辑器都支持待办事项的
Markdown任务完成（待办事项）语法:
- [ ] 计划任务
- [x] 完成任务
- 计划任务
- 完成任务
¶ 链接
¶ 超链接
格式：[文字描述](链接 "title")。
如需在新页面打开链接可在后面追加
{:target="_blank"}。但这种方法不是所有编辑器都支持。
在网页代码中head代码块中加上一行代码：<base target="_blank">。
加了这行代码以后，网页中的链接不用设置target="_blank"也会从新窗口中打开了。
直接展示网络地址 https://www.baidu.com 或 <https://www.baidu.com>
这是一个链接,带文字描述 [百度](https://www.baidu.com)
这是一个链接,带文字描述和title [百度](https://www.baidu.com "百度一下,你就知道") 鼠标悬浮在连接上看看
在新页面打开[百度](https://www.baidu.com "百度一下,你就知道"){:target="_blank"}
直接展示网络地址 https://www.baidu.com 或 https://www.baidu.com
这是一个链接,带文字描述 百度
这是一个链接,带文字描述和title 百度 鼠标悬浮在连接上看看
在新页面打开百度
¶ 脚注
脚注是对文本的补充说明。
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。
脚注自动被搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方。
Markdown脚注的格式如下：
一段内容 [^name]。
[^name]: 这是一个脚注
一段内容 [1]。
¶ html方式
使用html元素，添加id属性，建立一个跳转的链连接，这个语法和普通链接的语法一样，区别就是括号内的链接以#起始。
<a id = "element_id">如何Markdown中插入Mermaid流程图？</a>
[链接说明文字](#element_id)
¶ 图片
图片格式与超链接很像，前面多个!。
语法：
使用base64图片（会使md文件增大，建议图片不要太大太多）：
![avatar][doge]
<!- 放在文章末尾 ->
[doge]:data:image/png;base64,iVBORw0......
¶ 表格
| 左对齐 | 右对齐 | 居中对齐 |
| :----------- | -----------: | :------------:|
| 单元格左对齐 | 单元格右对齐 | 单元格居中对齐 |
| 单元格 | 单元格 | 单元格 |
| 左对齐 | 右对齐 | 居中对齐 |
|---|---|---|
| 单元格左对齐 | 单元格右对齐 | 单元格居中对齐 |
| 单元格 | 单元格 | 单元格 |
注意：
第二行分割表头和内容。
有一个就行，为了对齐，多加了几个
文字默认居左
两边加:表示文字居中
右边加:表示文字居右
原生的语法两边都要用|包起来。
¶ 目录
¶ 自动目录
在段落中填写 [TOC] 以显示全文内容的目录结构。
不是所有的markdown编辑器都支持
[TOC]
¶ 锚点
锚点其实就是页内超链接。比如我这里写下一个锚点，点击回到目录，就能跳转到目录。 在目录中点击这一节，就能跳过来。
上面说了html元素添id的方式，添加一个可跳转连接。这里再说个在标题后面添加锚点标记方法。
在你准备跳转到的指定标题后插入锚点{#标记}，然后在文档的其它地方写上连接到锚点的链接。
跳转到[插入Mermaid流程图](#mermaid)
# 插入Mermaid流程图{#mermaid}
跳转到插入Mermaid流程图
¶ emoji表情符号
emoji表情使用:EMOJICODE:的格式，详细列表可见
https://www.webpagefx.com/tools/emoji-cheat-sheet/
:smile: :laughing: :blush: :smiley:
¶ 支持的HTML元素
不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：
使用 <kbd>Ctrl</kbd>+<kbd>C</kbd> 复制，<kbd>Ctrl</kbd>+<kbd>V</kbd> 粘贴。
使用 Ctrl+C 复制，Ctrl+V 粘贴。
¶ 字符转义
Markdown 使用了很多特殊符号来表示特定的格式，如果需要显示这些特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符
**文本加粗**
\*\* 正常显示星号 \*\*
文本加粗
** 正常显示星号 **
¶ 插入Mermaid流程图
Markdown插入Mermaid流程图语法
``` mermaid
graph LR
A[长方形] -- 链接 --> B((圆))
A --> C(圆角长方形)
B --> D{菱形}
C --> D
```
graph LR A[长方形] -- 链接 --> B((圆)) A --> C(圆角长方形) B --> D{菱形} C --> D
¶ Markdown插入甘特图
```mermaid
gantt
dateFormat YYYY-MM-DD
title Adding GANTT diagram functionality to mermaid
section 现有任务
已完成 :done, des1, 2020-01-06, 4d
进行中 :active, des2, 2020-01-09, 3d
计划中 : des3, after des2, 5d
```
gantt dateFormat YYYY-MM-DD title Adding GANTT diagram functionality to mermaid section 现有任务 已完成 :done, des1, 2020-01-06, 4d 进行中 :active, des2, 2020-01-09, 3d 计划中 : des3, after des2, 5d
¶ 插入LaTeX公式
最简便的方法就是加两个$$, 然后在他们之间输入公式的latex语法，比如要插入 y = x , 则直接在两个$$之间输入y=x即可。
$$y=x$$
还可以插入更复杂公式，比如：
$$ x^{y^z}=(1+{\rm e}^x)^{-2xy^w} $$
$$ f(x,y,z) = 3y^2z \left( 3+\frac{7x+5}{1+y^2} \right) $$
$$ \left. \frac{{\rm d}u}{{\rm d}x} \right| _{x=0} $$
$$\frac{a-1}{b-1} \quad and \quad {a+1\over b+1}$$
$$\sqrt{2} \quad and \quad \sqrt[n]{3}$$
$$f(x_1,x_2,\underbrace{\ldots}_{\rm ldots} ,x_n) = x_1^2 + x_2^2 + \underbrace{\cdots}_{\rm cdots} + x_n^2$$
$$\vec{a} \cdot \vec{b}=0$$
$$\overleftarrow{xy} \quad and \quad \overleftrightarrow{xy} \quad and \quad \overrightarrow{xy}$$
$$\int_0^1 {x^2} \,{\rm d}x$$
$$ \lim_{n \to +\infty} \frac{1}{n(n+1)} \quad and \quad \lim_{x\leftarrow{示例}} \frac{1}{n(n+1)} $$
$$\sum_{i=1}^n \frac{1}{i^2} \quad and \quad \prod_{i=1}^n \frac{1}{i^2} \quad and \quad \bigcup_{i=1}^{2} R$$
$$
f\left(
\left[
\frac{
1+\left\{x,y\right\}
}{
\left(
\frac{x}{y}+\frac{y}{x}
\right)
\left(u+1\right)
}+a
\right]^{3/2}
\right)
\tag{行标}
$$
$$
\left\langle
q
\middle\|
\frac{\frac{x}{y}}{\frac{u}{v}}
\middle|
p
\right\rangle
$$
$$
\left[
\begin{array}{cc|c}
1&2&3\\
4&5&6
\end{array}
\right]
$$
$$
f(n) =
\begin{cases}
n/2, & \text{if $n$ is even} \\
3n+1, & \text{if $n$ is odd}
\end{cases}
$$
$$
\left.
\begin{array}{l}
\text{if $n$ is even:}&n/2\\
\text{if $n$ is odd:}&3n+1
\end{array}
\right\}
=f(n)
$$
$$
f(n) =
\begin{cases}
\frac{n}{2}, & \text{if $n$ is even} \\
3n+1, & \text{if $n$ is odd}
\end{cases}
$$
$$
\left\{
\begin{array}{c}
a_1x+b_1y+c_1z=d_1 \\
a_2x+b_2y+c_2z=d_2 \\
a_3x+b_3y+c_3z=d_3
\end{array}
\right.
$$
$$
x = a_0 + \cfrac{1^2}{a_1
+ \cfrac{2^2}{a_2
+ \cfrac{3^2}{a_3 + \cfrac{4^4}{a_4 + \cdots}}}}
$$
$$
x = a_0 + \frac{1^2}{a_1
+ \frac{2^2}{a_2
+ \frac{3^2}{a_3 + \frac{4^4}{a_4 + \cdots}}}}
$$
$$
x = a_0 + \frac{1^2}{a_1+}
\frac{2^2}{a_2+}
\frac{3^2}{a_3 +} \frac{4^4}{a_4 +} \cdots
$$
$$
\begin{array}{c|lcr}
n & \text{Left} & \text{Center} & \text{Right} \\
\hline
1 & 0.24 & 1 & 125 \\
2 & -1 & 189 & -8 \\
3 & -20 & 2000 & 1+10i
\end{array}
$$
$$ \left\{ \begin{array}{l}
0 = c_x-a_{x0}-d_{x0}\dfrac{(c_x-a_{x0})\cdot d_{x0}}{\|d_{x0}\|^2} + c_x-a_{x1}-d_{x1}\dfrac{(c_x-a_{x1})\cdot d_{x1}}{\|d_{x1}\|^2} \\[2ex]
0 = c_y-a_{y0}-d_{y0}\dfrac{(c_y-a_{y0})\cdot d_{y0}}{\|d_{y0}\|^2} + c_y-a_{y1}-d_{y1}\dfrac{(c_y-a_{y1})\cdot d_{y1}}{\|d_{y1}\|^2} \end{array} \right.
$$
latex参考资料：
LaTeX - A document preparation system
latex公式生成网 CodeCogs | Equation Editor
很全的latex语法文章
MathJax
在线LaTeX公式编辑器-编辑器
这是一个脚注 ↩︎