Markdown使用中的注意事项

本文主要关注Markdown使用时的高级用法和一些容易出现问题的地方，Markdown的基础用法大家可以查看简书官方关于Markdown的指南。本文主要包含6个方面的内容:

一、空格的使用:

标题字符(#)，列表字符( - / + / * / 1. / 2.)，引用字符(>)和文本之间要保留一个字符的空格。这是最标准的 Markdown 写法。这会避免因为Markdown编辑器的差异而出现显示的效果不一致的情况出现。

• 标题字符(#):

  代码:

  
  # 一级标题
  
  
  ## 二级标题
  
  
  ### 三级标题
  
  
  #### 四级标题
  
  
  ##### 五级标题
  
  
  ###### 六级标题 
  

• 无序列表字符( - / + / * ):

  - 文本1
  + 文本2
  * 文本3

• 有序列表字符(1. / 2. / 3.):

  1. 文本1
  2. 文本2
  3. 文本3

• 引用字符(>):

  > 引用文本

---

二、列表和代码块的对齐

（1）多级列表的对齐:

建立多级列表时，每个子级别都要比上个级别前面多打2个空格。

• 无序列表:

  - Item-1
  - Item-1-1
    + Item-1-1-1
      * Item-1-1-1-1
  * Item-1-2
  + Item-2
  * Item-3

• 有序列表:

  1. Item-1
  1.1. Item-1-1
    1.1.1. Item-1-1-1
      1.1.1.1. Item-1-1-1-1
  1.2. Item-1-2
  2. Item-2
  6. Item-3

（2）一个列表内部多个段落的对齐:

对应列表中的包含多个段落时,该列表下对应的各个段落的开头都要与第一个段落的开头对齐,如下面的例子中Code Line 1,Code Line 2和Code Line 3的开头是对齐的.

* Item-1
  * Code Line 1
    Code Line 2
    Code Line 3

编辑器解析的效果:

• Item-1
  
  • Code Line 1
    Code Line 2
    Code Line 3

（3）代码块的对齐

• 代码块内部的对齐:

  代码块使用字符构建时,文本的内容要与字符的位置对齐,如下面例子中的Code Line 1,Code Line 2和Code Line 3的开头都与字符的开头对齐了

  
Code Line 1
Code Line 2
Code Line 3


• 代码块与列表的对齐:

  在列表下的代码块字符的开头要与列表对应的段落开头对齐,比如下面这个例子对于Item-1.1下面的代码块,就是Item-1.1的开头与的开头对齐了

  • Item-1
    
    • Item-1.1
      
Code Line 1
Code Line 2
Code Line 3


---

三、网址链接的两种方式

Markdown关于添加图片和网址的语法很相似,只是插入图片的语法比插入网址前面多了一个感叹号”!”.它们都有两种插入方式,分别是:行内式和引用式(名字不重要,是我为了方便称呼自己取的)

注：Markdown不能设置图片的大小，如果必须设置，则应用HTML标记.

（1）行内式:

• 图片:

  [百度的图标](/path/to/img.jpg "Title(可以省略)")

• 网址: