前言

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/www/avatar.jpg "图片")

效果:

图片

链接

语法

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官方教程