Markdown 語法學習

簡介

Markdown 是一種輕量級標記語言，它用簡潔的語法代替排版，使咱們專心於碼字。它的目標是實現易讀易寫，成爲一種適用於網絡的書寫語言。同時，Markdown支持嵌入html標籤。

注意：Markdown使用#、+、*等符號來標記，符號後面必須跟上至少1個空格纔有效！

Markdown的經常使用語法

標題

Markdown 標題支持兩種形式：
一、用#標記：在標題開頭加上1~6個#，依次表明一級標題、二級標題....六級標題

# 一級標題
## 二級標題
### 三級標題
##### 四級標題
###### 五級標題
###### 六級標題

二、用=和-標記：在 標題底下加上任意個=表明一級標題，-表明二級標題（此方法適用於一級和二級標題）

一級標題
======

二級標題
----------

效果以下：

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

---

列表

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|
***

分隔線

在一行中用三個以上的 * 、- 、_ 來創建一個分隔線，行內不能有其餘東西。也能夠在符號間插入空格。

***
---
___

* * *

效果均爲一條分割線：
***
---

換行

在行尾添加兩個空格加回車表示換行：

這是一行後面加兩個空格  換行

效果以下：

這是一行後面加兩個空格 換行