Markdown语法

发表于 更新于 分类于 ， ， 阅读次数： 评论： 本文字数： 4.1k 阅读时长 ≈ 11 分钟

以下所有演示，后面紧接的都是它们的代码行。

一级标题

1
# 一级标题

二级标题

1
## 二级标题

三级标题

1
### 三级标题

四级标题

1
#### 四级标题
五级标题
1
##### 五级标题
六级标题
1
###### 六级标题

段落格式

分割线（水平线）

1
2
3
4
5
___

---

***

文本样式

This is bold text 加粗

This is bold text 加粗

1
2
**This is bold text 加粗**
__This is bold text 加粗__

This is italic text 斜体

This is italic text 斜体

1
2
*This is italic text 斜体*
_This is italic text 斜体_

粗斜体文本

粗斜体文本

1
2
***粗斜体文本***
___粗斜体文本___

Strikethrough 删除线

1
~~Strikethrough 删除线~~

xiahuaxian 下划线

1
<u>xiahuaxian 下划线</u>

Markdown 扩展语法 内联公式（例：\(\LaTeX\)​）

1
2
3
$$
\LaTeX
$$

下标（例：H20）

1
H~2~0

上标（例：X2）

1
X^2^

高亮（例：==key==）

1
==key==

脚注

创建脚注1

1
2
3
4
5
6
7
代码：
创建脚注[^脚注]
[^脚注]: 脚注：在文章末尾对特定名词进行解释说明

解释：
// [^脚注]是标记点
// 而[^脚注]: 则是脚注的详细内容

缩写

不同于HTML语法中的 缩写 ，比如： WTO

1
<abbr title="World Trade Organization">WTO</abbr>

判断框

  • 勾选

  • 不勾选

1
2
- [x] 勾选
- [ ] 不勾选

方框

使用HTML的pre标签可以实现方框的高亮提示。pre标签原本的使用是可以实现对空行和空格的保留，
如：
此例演示如何使用 pre 标签
    对空行
和    空格
        进行控制
1
2
3
4
5
6
<pre>使用HTML的<b>pre标签</b>可以实现方框的高亮提示。pre标签原本的使用是可以实现对空行和空格的保留，
如：
此例演示如何使用 pre 标签
  对空行
和    空格
    进行控制</pre>

列表

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，标记后跟一个空格，然后再填写内容。无序列表可以嵌套，通过 tab键 建立层次关系：

  • 第一层1
    • 第二层1
    • 第二层2
      • 第三层1
        • 第四层1
    • 第二层3
  • 第一层2
1
2
3
4
5
6
7
+ 第一层1
  + 第二层1
  + 第二层2
    + 第三层1
      + 第四层1
  + 第二层3
+ 第一层2

有序列表

在每行代码的最前面输入序号如（1. ），注意 . 后面有空格，有序列表同样可以嵌套。
注意：只要有了第一个序号的开始，后面的编号会依次开始排序，如（5. ，接下来的将会是6. ）

  1. Lorem ipsum dolor sit amet

  2. Consectetur adipiscing elit

    1. here
    2. there

  3. Integer molestie lorem at massa

  4. You can use sequential numbers...

  5. ...or keep all the numbers as 1.

按打头的编号开始排序:

  1. 从57开始
  2. 即使为 1. ，显示的序号也为58
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1. Lorem ipsum dolor sit amet
2. Consectetur adipiscing elit
  1. here
  2. there
3. Integer molestie lorem at massa


1. You can use sequential numbers...
1. ...or keep all the numbers as `1.`

按打头的编号开始排序:

57. 从57开始
1. 即使为 `1. ` ，显示的序号也为58

区块

在段落开头使用 > 符号 ，然后跟一个空格：

区块引用

区块衔接

1
2
3
> 区块引用
>
> 区块衔接

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

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

1
2
3
> 最外层  
> > 第一层嵌套  
> > > 第二层嵌套

区块中使用列表

注意空行！

区块中使用列表

  1. 第一项

  2. 第二项

  • 第一项
  • 第二项
1
2
3
4
5
6
7
8
> 区块中使用列表
>
> 1. 第一项
>
> 2. 第二项
>
> + 第一项
> + 第二项

列表中使用区块

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

注意空行！

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

  • 第一项

    区块引用

    区块衔接

  • 第二项

1
2
3
4
5
6
* 第一项
  
  > 区块引用
  >
  > 区块衔接
* 第二项

代码

高亮代码

code

1
`code`

代码块

空行式代码块

在Hexo-Next主题下，空行式代码块将不会显示代码行号，且没有复制按钮。类似于使用<pre>标签

line 1 of code
line 2 of code
line 3 of code
1
2
3
4
5
6
7
8
9
10
11
该种代码行的格式：  
`该段空行`
  前面空4格（一个tab的长度），该段开始为代码行
`结尾再空行，该段为结束`

演示如下：

  line 1 of code
  line 2 of code
  line 3 of code

反引号式代码块

如果你在代码块里使用了3个反引号（```），则代码块本身要用4个反引号！

1
2
3
line 1 of code
line 2 of code
line 3 of code
1
2
3
4
5
6
7
8
9
10
11
该种代码行的格式：
`3个反引号`
该段开始为代码行
`3个反引号`
演示如下：

```
line 1 of code
line 2 of code
line 3 of code
```
代码语法高亮
1
2
3
4
该种代码行的格式：
`3个反引号` `所使用的编程语言`
该段开始为代码行
`3个反引号`
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
演示如下：
var foo = function (bar) {
  return bar++;
};

console.log(foo(5));

源代码如下：
``` js
var foo = function (bar) {
  return bar++;
};

console.log(foo(5));
```

链接

这是一个链接 菜鸟教程

或者 https://www.runoob.com

1
2
3
这是一个链接 [菜鸟教程](https://www.runoob.com)

<https://www.runoob.com>

高级链接

链接也可以用变量来代替，文档末尾附带变量地址：
这个链接用 1 作为网址变量 Google
这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值（网址）

1
2
3
4
[Google][1]
[Runoob][2]  
[1]: http://www.google.com/  
[2]: http://www.runoob.com/

文章标题链接

  • 通过[名称](#标题名) 创建标题链接，跳转到该标题处

链接 反引号代码块

1
2
[链接](#链接)
[反引号代码块](#反引号式代码块)

图片

语法格式如下：

1
2
3
4
5
6
7
![图片名称](图片地址)
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)

![图片名称](图片地址 "可选标题")  
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">

使用实例： RUNOOB 图标

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

Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用HTML的 标签。

表格

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

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

语法格式如下：

1
2
3
4
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

对齐方式

我们可以设置表格的对齐方式： --: 设置内容和标题栏居右对齐。 :-- 设置内容和标题栏居左对齐。 :--: 设置内容和标题栏居中对齐。 实例如下：

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格 
1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :----: | ----:  |
| 单元格 | 单元格 | 单元格   |
| 单元格 | 单元格 | 单元格   |

支持的 HTML 元素

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

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>，如：

使用 Ctrl+Alt+Del 重启电脑

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

转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符（\），Markdown 使用反斜杠转义特殊字符： 文本加粗 ** 正常显示星号 **

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

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

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

公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

\[ \int \frac{1}{\sqrt{x^{2} \pm a^{2}}} d x=\ln |x+\sqrt{x^{2} \pm a^{2}}|+C \]