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
1. 有序列表2
    1.  有序列表2.1
    1.  有序列表2.2
        - 这
        - 无
            1. 有
            1. 序
        - 序
1. 有序列表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 address@example.com

展示如下：
http://example.com/ or address@example.com

• 插入互联网上图片，格式如下：

![这里写图片描述](http://img3.douban.com/mpic/s1108264.jpg)

或者如下面的写法：
![这里写图片描述][jane-eyre-douban]

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

---

6. 代码块

• 如果在一个行内需要引用代码，只要用反引号引起来就好，如下： Use theprintf()` 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