MarkDown详细使用方法

MarkDown详细使用方法

一、基础教程

1. 目录

MarkDown使用 [TOC] 生成标题

2. 标题

Markdown 标题有两种格式。一种为 Setext headers，另一种为 ATX headers。

Setext headers

Setext格式的标题分别使用 “=” 和 “-” 标记一级标题和二级标题，语法格式如下：

我展示的是一级标题
=================

我展示的是二级标题
-----------------

第一行是标题内容，由非空字符组成，而且缩进要小于一个Tab的长度。"=" 和 “-” 要紧跟着标题的下一行，"=" 和 “-” 字符的个数要大于1，两种字符可以混用。注意第二行个字符之间不能由空格或者除 “=” 和 “-” 之外的其他字符。

ATX headers

ATX格式的标题使用 “#” 标记，可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

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

3.段落格式

段落

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。当然也可以在段落后面使用一个空行来表示重新开始一个段落。

字体

Markdown 可以使用以下几种字体：

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

H~2~O is是液体。

2^10^ 运算结果是 1024.

H₂O 是液体。

2¹⁰ 运算结果是 1024。

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

***

* * *

*****

- - -

----------

删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可，实例如下：

GOOGLE.COM
~~BAIDU.COM~~

BAIDU.COM

下划线

下划线可以通过 HTML 的 <u> 标签来实现：

<u>带下划线文本</u>

带下划线文本

脚注

脚注是对文本的补充说明。

Markdown 脚注的格式如下:

[^要注明的文本]

以下实例演示了脚注的用法：

创建脚注格式类似这样 [^BAIDU]。

[^BAIDU]: 百度 -- 百度一下，你就知道！

4. 列表

Markdown 支持有序列表和无序列表。

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

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


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

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

1. 第一项
2. 第二项
3. 第三项

列表嵌套

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

1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

计划任务

- [ ] 计划任务
- [x] 完成任务

---

5. 区块（引用）

Markdown 区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号：

> 区块引用
> Google
> Baidu

区块引用
Google
Baidu

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推：

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

最外层

第一层嵌套

第二层嵌套

区块中使用列表

区块中使用列表实例如下：

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

区块中使用列表

1. 第一项
2. 第二项

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

列表中使用区块

如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。

区块中使用列表实例如下：

* 第一项
    > Google
    > Baidu
* 第二项

6. 代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（`），例如：

`printf()` 函数

printf() 函数

代码区块

代码区块使用 4 个空格或者一个制表符（Tab 键）。实例如下：

	print('Hello World!')

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

​```python
print('Hello World!')
​```

7. 链接

链接使用方法如下：

[链接名称](链接地址)

或者

<链接地址>

例如：

这是一个链接 [百度一下，你就知道](https://www.baidu.com)
这是一个链接 <https://www.baidu.com>

这是一个链接 百度一下，你就知道
这是一个链接 https://www.baidu.com

高级链接

我们可以通过变量来设置一个链接，变量赋值在文档末尾进行：

这个链接用 1 作为网址变量 [Google][1]
这个链接用 baidu 作为网址变量 [Baidu][baidu]
然后在文档的结尾为变量赋值（网址）

  [1]: http://www.google.com/
  [baidu]: http://www.baidu.com/

8. 图片

Markdown 图片语法格式如下：

![alt 属性文本](图片地址)

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

• 开头一个感叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

使用实例：

![Python 图标](https://www.python.org/static/img/python-logo.png)

![Python 图标](https://www.python.org/static/img/python-logo.png "Python")

当然，也可以像网址那样对图片网址使用变量:

这个链接用 1 作为网址变量 [Python][1].
然后在文档的结尾为变量赋值（网址）

[1]: https://www.python.org/static/img/python-logo.png

9. 表格

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

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

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

可以设置表格的对齐方式：

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

实例如下：

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

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

---

二、高级技巧

1. 支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

使用 Ctrl+Alt+Del 重启电脑

2. 转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符：

**文本加粗** 
\*\* 正常显示星号 \*\*

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

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

3. 公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 KaTeX 格式的数学公式来实现。

基本符号

LaTex	符号	LaTex	符号
+	$+$	-	$-$
\times	$\times$	\div	$÷$
\pm	$\pm$	\mp	$\mp$
\lt	$<$	\gt	$>$
\leq | \le	$\le$	\geq \ge	$\ge$
leqslant	$⩽$	\geqslant	$⩾$
\leqq	$\leqq$	\geqq	$\geqq$
\neq	$\ne$	\not\lt …	$\nless$ …
\overset{above}{level}	$\stackrel{above}{\mathrm{level}}$	\underset{below}{level}	$\underset{below}{\mathrm{level}}$
\cup	$\cup$	\cap	$\cap$
\setminus	$\setminus$	\backslash	$\backslash$
\subset	$\subset$	\supset	$\supset$
\subseteq	$\subseteq$	\supseteq	$\supseteq$
\subsetneq	$⊊$	\supsetneq	$⊋$
\emptyset	$\varnothing$	\varnothing	$\varnothing$
\dot x	$\dot{x}$	\ddot x	$\ddot{x}$
\cdot | x\cdot y	$\cdot$ | $x\cdot y$	\ldots	$\dots$
\ddots	$\ddots$	\vdots	$⋮$
\star	$\star$	\ast	$\ast$
\oplus	$\oplus$	\circ	$\circ$
\bullet	$\bullet$
\to | \rightarrow	$\to$ | $\to$	\leftarrow	$\leftarrow$
\Rightarrow	$\Rightarrow$	\Leftarrow	$\Leftarrow$
\mapsto	$\mapsto$
\hat x	$\hat{x}$	\widehat {xy}	$\widehat{xy}$
\bar x	$\bar{x}$	\overline {xy}	$\overline{xy}$
\vec x	$\vec{x}$	\overrightarrow x	$\overrightarrow{x}$
\overleftrightarrow {xy}	$\overleftrightarrow{xy}$
\land	$\wedge$	\lor	$\vee$
\lnot	$\neg$	\forall	$\forall$
\exists	$\exists$
\top	$\top$	\bot	$\perp$
\vdash	$⊢$	\vDash	$\models$
\approx	$\approx$	\sim	$\sim$
\simeq	$\simeq$	\cong	$\cong$
\equiv	$\equiv$	\prec	$\prec$
\lhd	$⊲$	a \equiv b\pmod n	$a\equiv b(\mathrm{m}\mathrm{o}\mathrm{d}n)$
\because	$\because$	\therefore	$\therefore$
\infty	$\infty$	\aleph | \aleph_0	$\aleph$ | ${\aleph }_0$
\nabla	$\nabla$	\partial	$\partial$
\Im	$\Im$	\Re	$\Re$
{n+1 \choose 2k} | \binom{n+1}{2k}	$\left(\genfrac{}{}{0ex}{}{n+1}{2k}\right)$	\operatorname{foo}(x)	$\mathrm{foo}(x)$
\sqrt 4 | \sqrt[3]9	$\sqrt{4}$ | $\sqrt[3]{9}$ …	2^9 | {...}^{1/2}	$2^9$ | ${...}^{1/2}$
a_1	$a_1$	\lim | \lim\limits_{x\to 10} （$..$ 和$$..$$ 格式下\lim_{x\to 10}的显示效果不同）	$\lim$ | $\underset{x\to 10}{\lim }$
\sin x | \cos x …	$\sin x$| $\cos x$ …	arcsin x| arccos x …	$\arcsin x$ | $\arccos x$ …

$X\overset{a}{\underset{b}{\to}}Y$

$$X\stackrel{a}{\underset{b}{\to }}Y$$

$\overset{ \huge\frown}{PQ}$

$$\stackrel{⌢}{\mathrm{PQ}}$$

$$
\underset{j=1}
{
	\overset{\infty}{\LARGE\mathrm K}}\frac{a_j}{b_j}
	=
	\cfrac{a_1}{b_1+\cfrac{a_2}{b_2+\cfrac{a_3}{b_3+\ddots}}
}
$$

$$\underset{j=1}{\stackrel{\infty }{\mathrm{K}}}\frac{a_j}{b_j}=\frac{a_1}{b_1+\frac{a_2}{b_2+\frac{a_3}{b_3+\ddots }}}$$

字母

Latex中各种希腊字母的书写形式如下表所示：

希腊字母小写、大写	LaTeX	希腊字母小写、大写	LaTeX
$$\alpha$$ $$A$$	\alpha A	$$\mu$$ $$N$$	\mu N
$$beta$$ $$B$$	\beta B	$$\xi$$ $$\Xi$$	\xi \Xi
$$\gamma$$ $$\Gamma$$	\gamma \Gamma	$$o$$ $$O$$	o O
$$\delta$$ $$\Delta$$	\delta \ Delta	π \pi