简介
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html
标签。
注意:Markdown使用#
、+
、*
等符号来标记, 符号后面必须跟上 至少1个 空格才有效!
Markdown的常用语法
标题
Markdown 标题支持两种形式:
1、用#
标记
在 标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
2、用=
和-
标记
在 标题底下 加上任意个=
代表一级标题,-
代表二级标题
一级标题
======
二级标题
----------
效果如下:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
Markdown 支持有序列表和无序列表。
无序列表使用-
、+
和*
作为列表标记:
- Red
- Green
- Blue
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
效果如下:
- Red
- Green
- Blue
有序列表则使用数字加英文句点.
来表示:
1\. Red
2\. Green
3\. Blue
效果如下:
- Red
- Green
- Blue
引用
引用以>
来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:
> 这是一段引用 //在`>`后面有 1 个空格
>
> 这是引用的代码块形式 //在`>`后面有 5 个空格
>
> 代码例子:
>
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
> 一级引用
> > 二级引用
> > > 三级引用
> #### 这是一个四级标题
>
> 1. 这是第一行列表项
> 2. 这是第二行列表项
效果如下:
这是一段引用
这是引用的代码块形式 //在`>`后面有 5 个空格
代码例子:
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
一级引用
二级引用
三级引用
这是一个四级标题
- 这是第一行列表项
- 这是第二行列表项
以下是分割线
强调
两个*
或-
代表加粗,一个*
或-
代表斜体,~~
代表删除。
**加粗文本** 或者 __加粗文本__
*斜体文本* 或者_斜体文本_
~~删除文本~~
效果如下:
加粗文本 或者 加粗文本
斜体文本 或者 斜体文本
删除文本
图片与链接
图片与链接的语法很像,区别在一个 ! 号。二者格式:
图片:![]() ![图片文本(可忽略)](图片地址)
链接:[]() [链接文本](链接地址)
链接又分为行内式
、参考式
和 自动链接
:
这是行内式链接:[ConnorLin's Blog](http://connorlin.github.io)。
这是参考式链接:[ConnorLin's Blog][url],其中url为链接标记,可置于文中任意位置。
[url]: http://connorlin.github.io/ "ConnorLin's Blog"
链接标记格式为:[链接标记文本]: 链接地址 链接title(可忽略)
这是自动链接:直接使用`<>`括起来
这是图片:![][avatar]
[avatar]: https://connorlin.github.io/images/avatar.jpg
效果如下:
这是行内式链接:ConnorLin's Blog。
这是参考式链接:ConnorLin's Blog,其中url为链接标记,可置于文中任意位置。
这是自动链接:直接使用<>
括起来http://connorlin.github.io
这是图片:
代码
代码分为行内代码
和代码块
。
行内代码使用
代码
标识,可嵌入文字中-
代码块使用4个空格或```标识
这里是代码
-
代码语法高亮在 ```后面加上
空格
和语言名称即可//注意语言前面有空格 这里是代码
例如:
这是行内代码`onCreate(Bundle savedInstanceState)`的例子。
这是代码块和语法高亮:
``` java
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
效果如下:
这是行内代码`onCreate(Bundle savedInstanceState)`的例子。
这是代码块和语法高亮:
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
## **表格**
表格对齐格式
* 居左:`:----`
* 居中:`:----:`或`-----`
* 居右:`----:`
例子:
标题 | 标题 | 标题 |
---|---|---|
居左测试文本 | 居中测试文本 | 居右测试文本 |
居左测试文本1 | 居中测试文本2 | 居右测试文本3 |
居左测试文本11 | 居中测试文本22 | 居右测试文本33 |
居左测试文本111 | 居中测试文本222 | 居右测试文本333 |
效果如下:
| 标题 | 标题 | 标题 |
| --- | --- | --- |
| 居左测试文本 | 居中测试文本 | 居右测试文本 |
| 居左测试文本1 | 居中测试文本2 | 居右测试文本3 |
| 居左测试文本11 | 居中测试文本22 | 居右测试文本33 |
| 居左测试文本111 | 居中测试文本222 | 居右测试文本333 |
* * *
## **分隔线**
在一行中用三个以上的`*`、`-`、`_`来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。
效果均为一条分割线:
* * *
* * *
## **换行**
在行尾添加两个空格加回车表示换行:
这是一行后面加两个空格 换行
效果如下:
这是一行后面加两个空格
换行
* * *
## **脚注(注解)**
使用`[^]`来定义脚注:
这是一个脚注的例子[1]
效果如下:
这是一个脚注的例子[[1]](#fn1)
* * *
# **常用弥补Markdown的Html标签**
## **字体**
字体及字体颜色和大小
字体颜色
效果如下:
字体及字体颜色和大小
字体颜色
* * *
## **换行**
使用html标签
换行
效果如下:
使用html标签`
`
换行
* * *
## **文本对齐方式**
居左文本
居中文本
居右文本
效果如下:
居左文本
居中文本
居右文本
* * *
## **下划线**
下划线文本
标题
这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上 #
即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 #
即可,标题字号相应降低。例如:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注:#
和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。
你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图:
列表
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 -
就可以了,例如:
- 文本1
- 文本2
- 文本3
如果你希望有序列表,
也可以在文字前面加上 1.
2.
3.
就可以了,例如:
1\. 文本1
2\. 文本2
3\. 文本3
注:-
、1.
和文本之间要保留一个字符的空格。
列表案例截图如下:
链接和图片
在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址)
这样的语法即可,例如:
[](http://www.jianshu.com)
在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片上传失败...(image-abcaf9-1601363065976)]
这样的语法即可,例如:
![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
注:插入图片的语法和链接的语法很像,只是前面多了一个 !
。
插入链接和图片的案例截图:
引用
在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 >
就好了,例如:
> 一盏灯, 一片昏黄; 一, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
注:>
和文本之间要保留一个字符的空格。
最终显示的就是:
一盏灯, 一片昏黄; 一, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
引用的案例截图:
粗体和斜体
Markdown 的粗体和斜体也非常简单,用两个 *
包含一段文本就是粗体的语法,用一个 *
包含一段文本就是斜体的语法。例如:
*一盏灯*, 一片昏黄;**一**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
最终显示的就是下文,其中「一盏灯」是斜体,「一」是粗体:
一盏灯, 一片昏黄;一, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
粗体和斜体的案例截图:
代码引用
需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。
代码引用的案例截图:
表格
相关代码:
| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
显示效果:
Tables | Are | Cool |
---|---|---|
col 3 is | right-aligned | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
相关代码:
dog | bird | cat
----|------|----
foo | foo | foo
bar | bar | bar
baz | baz | baz
显示效果:
dog | bird | cat |
---|---|---|
foo | foo | foo |
bar | bar | bar |
baz | baz | baz |
显示链接中带括号的图片
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1
代码如下:
![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1
-
这里是脚注 ↩