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

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

1. 标題與字号

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

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

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

一級标題

二級标題

三級标題

四級标題

五級标題

六級标題

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

等号及減号也可以進行标題的書寫，不過隻能書寫二級标題，并且需要寫在文字的下面，減号及等号的數量不會對标題的字号産生影響，如下：

二級标題
=========

二級标題
---------
           

二級标題

二級标題

一直覺得這個文法是對詭異的。因為

-

極可能是無序清單中的第一行。是以這個文法判斷時候，還要判斷

-

後面是否有一個空格。感覺文法很不舒服。這是為什麼呢？

解析一下：markdown文法類似

從A到B的轉移通過字元

-

,在B狀态下markdown認為這個上面的字元都要加粗。如果下一個字元是[空格]，那麼markdown認為是一個無序清單，将上面一行的所有文字的狀态置為不加粗。雖然這個是狀态的改變。但是在我們眼裡，這是之前文字的狀态改變。是以我們覺得這個文法就不舒服。因為我們習慣于向同一個方向書寫。而不是寫着寫着回顧另外一個方向。

2. 有序和無序

無序清單的使用，在符号“-”後加空格使用。如下：

另外注意

-

一定要是開始字元，如果不是那麼

-

之前隻能有空格或者tab字元。

- 無序清單
- 無序清單
- 無序清單
           

• 無序清單1
• 無序清單2
• 無序清單3

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

- 無序清單
- 無序清單
  - 無序清單
     - 清單内容
     - 清單内容
           

• 無序清單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]

• 插入網際網路上圖檔，格式如下：


或者如下面的寫法：
![這裡寫圖檔描述][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  is | right-aligned | $1600 |
| col  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