前言

Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，Markdown文件的后缀名便是“.md”。

Markdown基本语法

标题

示例：

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

字体

加粗，要加粗的文字左右分别用两个*号包起来

斜体，要倾斜的文字左右分别用一个*号包起来

斜体加粗，要倾斜和加粗的文字左右分别用三个*号包起来

删除线，要加删除线的文字左右分别用两个~~号包起来

示例：

1
2
3
4
**加粗文字**
*倾斜文字*
***斜体加粗文字***
~~删除线文字~~

效果：

加粗文字
倾斜文字`
斜体加粗文字
删除线文字

强调

Markdown 使用星号*和底线_作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 标签包围，用两个或_包起来的话，则会被转成，

示例：

1
2
3
4
5
6
7
*single asterisks*
​
_single underscores_
​
**double asterisks**
​
__double underscores__

HTML:

1
2
3
4
5
6
7
<em>single asterisks</em>
​
<em>single underscores</em>
​
<strong>double asterisks</strong>
​
<strong>double underscores</strong>

效果：

single asterisks
​
single underscores
​
double asterisks
​
double underscores

角标

上标，文字右侧输入^
下标，文字右侧输入~

示例：

1
2
2^10^ #上标
H~2~o #下标

效果：

210
H2O

引用

在引用的文字前加>

示例：

1
2
>这是引用的内容
>> 引用的内容

效果:

这是引用的内容

引用的内容

分割线

三个或者三个以上的 - 或者 * 都可以。

示例：

1
2
3
4
---
----
***
*****

以上分隔线的渲染效果看起来都一样

图片

语法：

1
2
3
4
![图片alt](图片地址 ''图片title'')

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

示例：

1
![图片](https://img.huyw96.com/avatar.png "图片")

效果：

图片

链接

语法

1
2
显示链接：<超链接名>
显示链接描述：[超链接名](超链接地址 "超链接title")，title可加可不加

示例：

1
2
<https://www.huyw96.com/posts/5d36ff15/>
[Markdown基本语法](https://www.huyw96.com/posts/5d36ff15/ "Markdown基本语法")

效果：

https://www.huyw96.com/posts/5d36ff15/
Markdown基本语法

列表

有序列表

语法：

数字加点

示例：

1
2
3
4
5
1. 列表内容
2. 列表内容
3. 列表内容

注意：序号跟内容之间要有空格

效果：

  1. 列表内容
  2. 列表内容
  3. 列表内容

无序列表

语法：

用 - + * 任何一种都可以

示例：

1
2
3
4
5
- 列表内容
+ 列表内容
* 列表内容

注意：- + * 跟内容之间都要有一个空格

效果：

  • 列表内容
  • 列表内容
  • 列表内容

列表嵌套

上一级和下一级之间敲三个空格即可

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
- 一级无序列表内容

   - 二级无序列表内容
   - 二级无序列表内容
   - 二级无序列表内容

- 一级无序列表内容

   1. 二级有序列表内容
   2. 二级有序列表内容
   3. 二级有序列表内容

1. 一级有序列表内容

   - 二级无序列表内容
   - 二级无序列表内容
   - 二级无序列表内容

2. 一级有序列表内容

   1. 二级有序列表内容
   1. 二级有序列表内容
   1. 二级有序列表内容

效果：

  • 一级无序列表内容

    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容

  • 一级无序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

  1. 一级有序列表内容

    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容

  2. 一级有序列表内容

    1. 二级有序列表内容
    2. 二级有序列表内容
    3. 二级有序列表内容

表格

语法：

1
2
3
4
5
6
7
8
9
10
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右
注：原生的语法两边都要用 | 包起来。此处省略

示例：

1
2
3
4
5
表头A|表头B|表头C
:-|:-:|-:
内容A1|内容B1|内容C1
内容A2|内容B2|内容C2
内容A3|内容B3|内容C3

效果：

表头A 表头B 表头C
内容A1 内容B1 内容C1
内容A2 内容B2 内容C2
内容A3 内容B3 内容C3

代码

语法

单行代码：代码之间分别用一个反引号包起来

1
`代码内容`

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

1
2
3
4
5
(```)
  代码...
  代码...
  代码...
(```)

注：为了防止转译，前后三个反引号处加了小括号，实际是没有的。这里只是用来演示，实际中去掉两边小括号即可。

示例

单行代码

1
`hello world`

代码块

1
2
3
4
5
(```)
function test() {
   console.log("Hello world!");
}
(```)

效果

单行代码

hello world

代码块

1
2
3
function test() {
   console.log("Hello world!");
}

支持语言

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
actionscript3
apache
applescript
asp
brainfuck
c
cfm
clojure
cmake
coffee-script, coffeescript, coffee
cpp - C++
cs
csharp
css
csv
bash
diff
elixir
erb - HTML + Embedded Ruby
go
haml
http
java
javascript
json
jsx
less
lolcode
make - Makefile
markdown
matlab
nginx
objectivec
pascal
PHP
Perl
python
profile - python profiler output
rust
salt, saltstate - Salt
shell, sh, zsh, bash - Shell scripting
sql
scss
sql
svg
swift
rb, jruby, ruby - Ruby
smalltalk
vim, viml - Vim Script
volt
vhdl
vue
xml - XML and also used for HTML with inline CSS and Javascript
yaml

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号

示例：

如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 `` 标签），你可以在星号的前面加上反斜杠

1
\*literal asterisks\*

效果：

*literal asterisks*

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

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

编辑器推荐

Windows：Typora

在线编辑器：markdown

官方教程

Markdown官方教程