CSDN markdown 編輯器 第三篇 基本語法篇

這一篇準備抄一下help文檔，另外加一些自己的解釋。這一篇裏不講UML和LaTEX。 準備抽兩個篇專門講一下。

1. 標題與字號

markdown字號太少了，覺得應該再加些。

在文字寫書寫不同數量的#可以完成不同的標題，如下：

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

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

這裏的需要注意的是 #[空格]標題 一定要有空格

等號及減號也可以進行標題的書寫，不過只能書寫二級標題，並且需要寫在文字的下面，減號及等號的數量不會對標題的字號產生影響，如下：

二級標題
=========

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

二級標題

二級標題

一直覺得這個語法是對詭異的。因爲- 極可能是無序列表中的第一行。所以這個語法判斷時候，還要判斷-後面是否有一個空格。感覺文法很不舒服。這是爲什麼呢？

解析一下：markdown文法類似

從A到B的轉移通過字符-,在B狀態下markdown認爲這個上面的字符都要加粗。如果下一個字符是[空格]，那麼markdown認爲是一個無序列表，將上面一行的所有文字的狀態置爲不加粗。雖然這個是狀態的改變。但是在我們眼裏，這是之前文字的狀態改變。所以我們覺得這個文法就不舒服。因爲我們習慣於向同一個方向書寫。而不是寫着寫着回顧另外一個方向。

---

2. 有序和無序

無序列表的使用，在符號“-”後加空格使用。如下：
另外注意 -一定要是開始字符，如果不是那麼-之前只能有空格或者tab字符。

- 無序列表1
- 無序列表2
- 無序列表3

• 無序列表1
• 無序列表2
• 無序列表3

如果要控制列表的層級，則需要在符號“-”前使用空格或者tab。如下：

- 無序列表1
- 無序列表2
  - 無序列表2.1
     - 列表內容
     - 列表內容

• 無序列表1
• 無序列表2
  
  • 無序列表2.1
    
    • 列表內容
    • 列表內容

有序列表的使用，在數字及符號“.”後加空格幾個，如下：

1. 有序列表1
2. 有序列表2
    3.  有序列表2.1
    4.  有序列表2.2
        - 這
        - 無
            1. 有
            2. 序
        - 序
3. 有序列表3

1. 有序列表1
2. 有序列表2
   
   1. 有序列表2.1
   2. 有序列表2.2
      
      • 這
      • 無
        
        1. 有
        2. 序
      • 序
3. 有序列表3

有序列表如果要區分層級，也可以在數字前加空格或者tab。

---

3. 引用

引用的格式是使用符號“>”後面書寫文字. ”>“之後是否加空格不影響。如下：

> 我說的都是我說的——帳前卒

我說的都是我說的——帳前卒

---

4. 粗體和斜體

粗體和斜體： 一個*兩個* 還是三個*. 注意**[你的字符]**中*號和你的字符之間沒有空格。
一個*:*你是斜體*你是斜體
兩個*:**不對，你是粗體**不對，你是粗體
三個*:***你又粗又斜***你又粗又斜

---

5. 鏈接

• 在引用中加鏈接，第一個中括號添加需要添加的文字，第二個中括號中是引用鏈接的id，之後在引用中，使用id加鏈接：如下：

    [link text][id]
    [id]: http://example.com/ "optional title here"

上面的文字將展示爲：

link text

• 在文中直接引用鏈接，直接使用尖括號，把鏈接加入到尖括號中就可以實現，如下：

  http://example.com/ or [email protected]

展示如下：
http://example.com/ or [email protected]

• 插入互聯網上圖片，格式如下：

![這裏寫圖片描述](http://img3.douban.com/mpic/s1108264.jpg)

        

或者如下面的寫法：
![這裏寫圖片描述][jane-eyre-douban]

[jane-eyre-douban]: http://img3.douban.com/mpic/s1108264.jpg`

        

---

## 6. 代碼塊 - 如果在一個行內需要引用代碼，只要用反引號`引起來就好，如下： Use the `printf()` function. - 用TAB鍵起始的段落，會被認爲是代碼塊，如下： echo “hello world”; - 如果TAB不管用的話，需要使用三個反引號` 例如： 下面連高亮都做了。

<php>
    echo "hello world";
</php>

---

7. 分割線和刪除線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，同時需要在分隔線的上面空一行。如下：

---
****
___
展示如下：

---

---

---

刪除線的使用，在需要刪除的文字前後各使用兩個符號“~”，如下

~~Mistaken text.~~

Mistaken text.

---

8. 表格

可以使用冒號來定義表格的對齊方式，如下：

| Tables | Are | Cool |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
| somemissed |
|||$20|

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1
somemissed
		$20