简介
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。
注意:Markdown使用#、+、*等符号来标记,符号后面必须跟上至少1个空格才有效!
Markdown的常用语法
标题
Markdown 标题支持两种形式:
1、用#标记:在标题开头加上1~6个#,依次代表一级标题、二级标题....六级标题
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
2、用=和-标记:在 标题底下加上任意个=代表一级标题,-代表二级标题(此方法适用于一级和二级标题)
一级标题
======
二级标题
----------
效果如下:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
Markdown 支持有序列表和无序列表。
无序列表使用-、+和*作为列表标记:
- Red
- Green
- Blue
* Red
* Green
* Blue
+ Red
+ Green
+ Blue
效果如下:
- Red
- Green
- Blue
- yellow
- Black
- pink
- pink
- Blue
有序列表则使用数字加英文句点.来表示:
1. Red
2. Green
3. Blue
效果如下:
- Red
- Green
- Blue
- yellow
- Black
- pink
- Blue
引用
引用以>来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法:
> 这是一段引用 //在`>`后面有 1 个空格
>
> 这是引用的代码块形式 //在`>`后面有 5 个空格
>
> 代码例子:
>
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
> 一级引用
> > 二级引用
> > > 三级引用
> #### 这是一个四级标题
>
> 1. 这是第一行列表项
> 2. 这是第二行列表项
效果如下:
这是一段引用 //在
>
后面有 1 个空格这是引用的代码块形式 //在`>`后面有 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(可忽略)
这是自动链接:直接使用`<>`括起来<http://connorlin.github.io>
这是图片:![][avatar]
[avatar]: https://connorlin.github.io/images/avatar.jpg
效果如下:
这是行内式链接:ntsclong Blog。
这是参考式链接:ntsclong Blog,其中url为链接标记,可置于文中任意位置。
链接标记格式为:[链接标记文本]: 链接地址 链接title(可忽略)
这是自动链接:直接使用<>
括起来http://www.ntsclong.com
这是图片:
视频插入
注:Markdown 语法是不支持直接插入视频的
普遍的做法是插入HTML的iframe标签,src可以通过网站自带的分享功能获取
将图片中的iframe标签添加进去
<iframe height=498 width=510 src='http://player.youku.com/embed/XMjgzNzM0NTYxNg==' frameborder=0 'allowfullscreen'>
第二是伪造播放界面,插入视频播放图片,点击时跳转到相关页面
代码
代码分为行内代码和代码块。
-
行内代码使用`代码`标识,可嵌入文字中
-
代码块使用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 |
分隔线
在一行中用三个以上的 * 、- 、_ 来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。
***
---
___
* * *
效果均为一条分割线:
换行
在行尾添加两个空格加回车表示换行:
这是一行后面加两个空格 换行
效果如下:
这是一行后面加两个空格
换行