Markdown 入门

Markdown 的目标是实现易写易读。

Markdown 语法

区块元素

• 换行

  行尾使用两个以上空格，然后回车。

• 标题

  Markdown 支持两种语法的标题。

  • 利用底线=或-

    最高等级标题
    ==========
    
    第二等级标题
    ----------
    

  • 行首以 # 开始

    # 这是H1
    ## 这是H2
    ### 这是H3
    ...
    ###### 这是H6
    

• 引用

  > 这里是引用的内容
  

• 列表

  无序列表可以用三种方式表达。

  • 利用 +

    + 无序列表
    

  • 利用 -

    - 无序列表
    

  • 利用 *

    * 无序列表
    

  有序列表用数字加点表达。

  1. 有序列表
  

  标记上使用的数字不影响输出的 HTML。

• 分割线

  分割线可以用两种符号表达。

  • 利用三个以上 *

    ***
    ****
    * * *
    

  • 利用三个以上 -

    ---
    ----
    - - -
    

区段元素

• 链接

  [text](http://link.com 'title')
  

  当一个链接会被多次使用时，可以利用 参考式 。参考式可以在当前文档下任何地方定义。 参考式 定义与使用：

  [1]: http://link.com "title"
  
  [text][1]
  

• 强调

  强调可以使用两种符号表达。

  • 利用 *

    *强调内容*
    **强调内容**
    

  • 利用 _

    _强调内容_
    __强调内容__
    

• 代码

  代码可以使用两种方式表达。

  • 利用 `

  • 利用 ```包裹

• 图片

  ![alt text](http:imageLink.com 'title')
  

  图片参考式和链接参考式写法相同。

Markdown 约定

通用约定

• 数字、英文与中文相邻需要用空格分隔
• 标题、块代码、图片、表格上下用空行分隔
• 列表文本结尾不加标点符号
• 注意强调与代码片段区别使用

标题

选择使用以下三种 Markdown 标题。

### H3
#### H4
##### H5

目录

一级目录使用有序列表，二级目录使用无序列表。

1. [title](#1)
    + [title](#1-1)

<a name="1"></a>

列表

列表上下各留一行间距，无序列表使用 + 。

代码

行内短代码与行内其他文本各留一个空格间距，代码内前后各留一个空格间距。代码块上下各留一行间距。

链接

链接使用无 title 链接。

[text](http://link.com)

强调

强调使用 ** 、 *

图片

图片使用无 title 图片。

![Alt text](http:imageLink.com)

分割线

选择使用 - - - 。