0 写在前面
本文提供了Markdown的简单概念,Markdown很简单就可以上手。Markdown的语法非常简单,本文提供了一些示例,每个示例都会提供输出的HTML结果。
你也可以通过typora这个极简的Markdown文本编辑器,尝试自己编写Markdown文档,非常方便。
本文是通过Markdown编写的,你可以在文章的末尾查看本文的 全部源码 做参考
下面介绍几种常见的Markdown语法。
1 标题
标题可以在行首插入1到6个#
来表示。在#
和标题内容
之间,有一个空格
。最多可以有6个#
,来表示不同大小的标题。#
越多,标题越小。例如:
### 我是一个3级标题
的效果如下:
我是一个3级标题
再例如:
###### 我是一个6级标题
的效果如下:
我是一个6级标题
2 斜体,粗体,粗斜体,删除线
2.1 斜体
可以在文本的前后,各添加一个*
表示斜体
,例如:
*Hello World!*
的效果如下:
Hello World!
2.2 粗体
可以在文本的前后,各添加两个*
来表示粗体
,例如:
**Hello World!**
的效果如下:
Hello World!
2.3 粗斜体
可以在文本的前后,各添加3个*
来表示粗斜体
,例如:
***Hello World!***
的效果如下:
Hello World!
2.4 删除线
可以在文本的前后,各添加两个~
来表述删除线
,例如:
~~Hello World~~
的效果如下:
Hello World!
3 引用,代码
3.1 引用
可以在引用内容前添加一个英文符号>
来表示引用内容,例如:
> To be or not to be, it is a question.
的效果如下:
To be or not to be, it is a question.
3.2 代码
可以在代码的前后,各添加3个`来表示代码,例如:
```
<html>
<body>
<p>我是一段性感的文字</p>
</body>
</html>
```
的效果如下:
<html>
<body>
<p>我是一段性感的文字</p>
</body>
</html>
也可以在第一个```的后面,加上代码所使用的编程语言,还可以让代码增加可读性。例如:
``` java
public static void main(String[] args) {
System.out.println("Hello World!");
}
```
的效果如下:
public static void main(String[] args) {
System.out.println("Hello World!");
}
4 分割线
可以连续使用3个*
或者3个-
来表示一个分割线,例如:
***
的效果如下:
再例如:
---
的效果如下:
5 图片
可以通过 ![图片名](图片地址)
来表示图片。图片地址可以是网络地址,也可以是本机或本地服务器的地址,例如:
![简书图片](https://upload-images.jianshu.io/upload_images/25794683-ee20c79802cfa9ac.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
的效果如下:
6 超链接
可以通过 [文字](链接地址)
来表示超链接。例如:
[点击跳转到百度](https://www.baidu.com)
的效果如下:
7 列表
7.1 无序列表
可以在列表的各项之前,添加-
来表示无序列表,-
和内容之间有一个空格
,例如:
- 鸡蛋
- 蘑菇
- 土豆
的效果如下:
- 鸡蛋
- 蘑菇
- 土豆
7.2 有序列表
可以在列表的各项之前,添加1.
2.
3.
来表示有序列表,1.
和内容之间有一个空格
,例如:
1. 猪骨头火锅
2. 酸菜鱼火锅
3. 麻辣火锅
的效果如下:
- 猪骨头火锅
- 酸菜鱼火锅
- 麻辣火锅
8 表格
表格的表示略微复杂,格式要求为
列名1|列名2|列名3|列名4
--|--|--|--|
表格项1|表格项2|表格项3|表格项4
表格项5|表格项6|表格项7|表格项8
其中
--|--|--|--|
用来区分标题和内容,例如:
列名1|列名2|列名3|列名4
--|--|--|--|
表格项1|表格项2|表格项3|表格项4
表格项5|表格项6|表格项7|表格项8
表格项9|表格项10|表格项11|表格项12
的效果如下:
列名1 | 列名2 | 列名3 | 列名4 |
---|---|---|---|
表格项1 | 表格项2 | 表格项3 | 表格项4 |
表格项5 | 表格项6 | 表格项7 | 表格项8 |
表格项9 | 表格项10 | 表格项11 | 表格项12 |
再例如:
名字|性别|生日
--|--|--|
张三|男|1997.1.1
李四|男|1999.5.1
王五|男|1997.4.1
的效果如下:
名字 | 性别 | 生日 |
---|---|---|
张三 | 男 | 1997.1.1 |
李四 | 男 | 1999.5.1 |
王五 | 男 | 1997.4.1 |
9 本文源码
## 0 写在前面
本文提供了Markdown的简单概念,Markdown很简单就可以上手。Markdown的语法非常简单,本文提供了一些示例,每个示例都会提供输出的HTML结果。
你也可以通过[typora](https://typora.io)这个极简的Markdown文本编辑器,尝试自己编写Markdown文档,非常方便。
本文是通过Markdown编写的,你可以在文章的末尾查看本文的 ***全部源码*** 做参考
下面介绍几种常见的Markdown语法。
## 1 标题
标题可以在行首插入1到6个`#`来表示。在`#`和`标题内容`之间,有一个`空格`。最多可以有6个`#`,来表示不同大小的标题。`#`越多,标题越小。例如:
``` markdown
### 我是一个3级标题
```
的效果如下:
### 我是一个3级标题
再例如:
``` markdown
###### 我是一个6级标题
```
的效果如下:
###### 我是一个6级标题
## 2 斜体,粗体,粗斜体,删除线
### 2.1 斜体
可以在文本的前后,各添加一个`*`表示`斜体`,例如:
``` markdown
*Hello World!*
```
的效果如下:
*Hello World!*
### 2.2 粗体
可以在文本的前后,各添加两个`*`来表示`粗体`,例如:
``` markdown
**Hello World!**
```
的效果如下:
**Hello World!**
### 2.3 粗斜体
可以在文本的前后,各添加3个`*`来表示`粗斜体`,例如:
```
***Hello World!***
```
的效果如下:
***Hello World!***
### 2.4 删除线
可以在文本的前后,各添加两个`~`来表述`删除线`,例如:
``` markdown
~~Hello World~~
```
的效果如下:
~~Hello World!~~
## 3 引用,代码
### 3.1 引用
可以在引用内容前添加一个英文符号`>`来表示引用内容,例如:
``` markdown
> To be or not to be, it is a question.
```
的效果如下:
> To be or not to be, it is a question.
### 3.2 代码
可以在代码的前后,各添加3个`来表示代码,例如:
``` markdown
```
<html>
<body>
<p>我是一段性感的文字</p>
</body>
</html>
```
```
的效果如下:
```
<html>
<body>
<p>我是一段性感的文字</p>
</body>
</html>
```
也可以在第一个```的后面,加上代码所使用的编程语言,还可以让代码增加可读性。例如:
``` markdown
``` java
public static void main(String[] args) {
System.out.println("Hello World!");
}
```
```
的效果如下:
``` java
public static void main(String[] args) {
System.out.println("Hello World!");
}
```
## 4 分割线
可以连续使用3个`*`或者3个`-`来表示一个分割线,例如:
```
***
```
的效果如下:
***
再例如:
``` markdown
---
```
的效果如下:
---
## 5 图片
可以通过 `![图片名](图片地址)` 来表示图片。图片地址可以是网络地址,也可以是本机或本地服务器的地址,例如:
``` markdown
![简书图片](https://upload-images.jianshu.io/upload_images/25794683-ee20c79802cfa9ac.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
```
的效果如下:
![简书图片](https://upload-images.jianshu.io/upload_images/25794683-ee20c79802cfa9ac.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
## 6 超链接
可以通过 `[文字](链接地址)`来表示超链接。例如:
``` markdown
[点击跳转到百度](https://www.baidu.com)
```
的效果如下:
[点击跳转到百度](https://www.baidu.com)
## 7 列表
### 7.1 无序列表
可以在列表的各项之前,添加`-`来表示无序列表,`-`和内容之间有一个`空格`,例如:
```markdown
- 鸡蛋
- 蘑菇
- 土豆
```
的效果如下:
- 鸡蛋
- 蘑菇
- 土豆
### 7.2 有序列表
可以在列表的各项之前,添加`1.` `2.` `3.`来表示有序列表,`1.`和内容之间有一个`空格`,例如:
``` markdown
1. 猪骨头火锅
2. 酸菜鱼火锅
3. 麻辣火锅
```
的效果如下:
1. 猪骨头火锅
2. 酸菜鱼火锅
3. 麻辣火锅
## 8 表格
表格的表示略微复杂,格式要求为
``` markdown
列名1|列名2|列名3|列名4
--|--|--|--|
表格项1|表格项2|表格项3|表格项4
表格项5|表格项6|表格项7|表格项8
```
其中
``` markdown
--|--|--|--|
```
用来区分标题和内容,例如:
``` markdown
列名1|列名2|列名3|列名4
--|--|--|--|
表格项1|表格项2|表格项3|表格项4
表格项5|表格项6|表格项7|表格项8
表格项9|表格项10|表格项11|表格项12
```
的效果如下:
列名1|列名2|列名3|列名4
--|--|--|--|
表格项1|表格项2|表格项3|表格项4
表格项5|表格项6|表格项7|表格项8
表格项9|表格项10|表格项11|表格项12
再例如:
``` markdown
名字|性别|生日
--|--|--|
张三|男|1997.1.1
李四|男|1999.5.1
王五|男|1997.4.1
```
的效果如下:
名字|性别|生日
--|--|--|
张三|男|1997.1.1
李四|男|1999.5.1
王五|男|1997.4.1