简介
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html
标签。
注意:Markdown使用#
、+
、*
等符号来标记, 符号后面必须跟上 至少1个 空格才有效!
Markdown的常用语法
标题
Markdown 标题支持两种形式:
- 用
#
标记
在 标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
- 用
=
和-
标记
在 标题底下 加上任意个=
代表一级标题,-
代表二级标题
效果如下:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
Markdown 支持有序列表和无序列表。
无序列表使用-
、+
和*
作为列表标记:
- 昨天
- 今天
- 明天
* 昨天
* 今天
* 明天
+ 昨天
+ 今天
+ 明天
效果如下:
- 昨天
- 今天
- 明天
有序列表则使用数字加英文句点.
来表示:
1. 昨天
2. 今天
3. 明天
效果如下:
- 昨天
- 今天
- 明天
引用
引用以>
来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:
> 这是一段引用 //在`>`后面有 1 个空格
>
> 这是引用的代码块形式 //在`>`后面有 5 个空格
>
> 代码例子:
>
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
> 一级引用
> > 二级引用
> > > 三级引用
> #### 这是一个四级标题
>
> 1. 这是第一行列表项
> 2. 这是第二行列表项
效果如下:
这是一段引用
这是引用的代码块形式
代码例子:
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); }
一级引用
二级引用
三级引用
这是一个四级标题
- 这是第一行列表项
- 这是第二行列表项
字体
- 加粗
要加粗的文字左右分别用两个*
号包起来 - 斜体
要倾斜的文字左右分别用一个*
号包起来 - 斜体加粗
要倾斜和加粗的文字左右分别用三个*
号包起来 - 删除线
要加删除线的文字左右分别用两个~~
号包起来
**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~
效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字这是加删除线的文字
分割线
三个或者三个以上的 -
或者 *
都可以。
---
----
***
*****
效果示例
图片与链接
图片与链接的语法很像,区别在一个 ! 号。二者格式:

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
效果如下:
表格
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略
效果如下:
请求参数名 | 请求类型 | 参数必填 |
---|---|---|
username | string | 是 |
password | string | 是 |
代码
语法:
单行代码:代码之间分别用一个反引号包起来
`代码内容`
代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行
(```)
代码...
代码...
代码...
(```)
注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。
示例
单行代码代码内容
代码块
代码...
代码...
代码...
超链接
[超链接名](超链接地址 "超链接title")
title可加可不加
效果如下
百度
Giles'Blog