Markdown 语法学习

简介

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
      
      

有序列表则使用数字加英文句点.来表示：

1. Red
2. Green
3. Blue

效果如下：

1. Red
2. Green
   1. Blue
      1. yellow
   2. Black
      1. pink

引用

引用以>来表示，引用中支持多级引用、标题、列表、代码块、分割线等常规语法。
常见的引用写法：

> 这是一段引用    //在`>`后面有 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);
}

一级引用

二级引用

三级引用

这是一个四级标题

1. 这是第一行列表项
2. 这是第二行列表项

---

强调

两个 * 或 - 代表加粗，一个 * 或 - 代表斜体，~~ 代表删除。

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

~~删除文本~~

效果如下：

加粗文本 或者 加粗文本

斜体文本 或者 斜体文本

删除文本

---

图片与链接

图片与链接的语法很像，区别在一个 ! 号。
二者格式：

图片：![]()    ![图片文本(可忽略)](图片地址)

链接：[]()     [链接文本](链接地址)

链接又分为行内式、参考式和 自动链接：

这是行内式链接：[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

---

分隔线

在一行中用三个以上的 * 、- 、_ 来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

***
---
___

* * *

效果均为一条分割线：

---

---

换行

在行尾添加两个空格加回车表示换行：

这是一行后面加两个空格  换行

效果如下：

这是一行后面加两个空格
换行