Contents
  1. 1. 段落和换行
  2. 2. 标题
  3. 3. 强调
  4. 4. 引用
  5. 5. 列表
  6. 6. 行内代码
  7. 7. 代码区块
  8. 8. 分隔线
  9. 9. 链接
    1. 9.0.1. 参考式的链接
  • 10. 图片
    1. 10.0.1. 行内式
  • 11. 自动链接
  • 段落和换行

    「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行(插入换行符),so如果你确实想要依赖 Markdown 来插入换行标签的话,在插入处先按入两个以上的空格然后回车

    标题

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

    强调

    Markdown 使用星号和下划线作为标记强调字词的符号,被1个标记包围的字词会被转成用 em标签包围,用两个包起来的话,则会被转成 strong

    _强调_
    *强调*
    **大强调**
    ***大大强调***
    

    引用

    > This is the first level of quoting.
    >
    > > This is nested blockquote.
    >
    > Back to the first level.
    

    列表

    无序列表使用星号、加号或是减号作为列表标记:

    *   Red
    *   Green
    *   Blue
    

    等同于:

    +   Red
    +   Green
    +   Blue
    

    也等同于:

    -   Red
    -   Green
    -   Blue
    

    有序列表则使用数字接着一个英文句点:

    1.  Bird
    2.  McHale
    3.  Parish
    

    行内代码

    如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:

    Use the `printf()` function.
    

    代码区块

    只要简单地缩进 4 个空格或是 1 个制表符就可以

    这是一个普通段落:
    
        这是一个代码区块。
    

    分隔线

    在一行中用三个以上的星号、减号、底线来建立一个分隔线

    * * *
    
    ***
    
    *****
    
    - - -
    

    链接

    Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。

    ###行内式的链接
    只要在方块括号后面紧接着圆括号并插入网址链接即可,链接的 title在网址后面,用双引号把 title 文字包起来即可,例如:

    This is [an example](http://example.com/ "Title") inline link.
    
    [This link](http://example.net/) has no title attribute.
    

    如果你是要链接到同样主机的资源,你可以使用相对路径:

    See my [About](/about/) page for details.
    

    参考式的链接

    在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:

    This is [an example][id] reference-style link.
    

    接着,在文件的任意处,你可以把这个标记的链接内容定义出来:

    [id]: http://example.com/  "Optional Title Here"
    

    隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 “Google” 链接到 google.com,你可以简化成:

    [Google][]
    

    然后定义链接内容:

    [Google]: http://google.com/
    

    下面是一个参考式链接的范例:

    I get 10 times more traffic from [Google] [1] than from
    [Yahoo] [2] or [MSN] [3].
    
      [1]: http://google.com/        "Google"
      [2]: http://search.yahoo.com/  "Yahoo Search"
      [3]: http://search.msn.com/    "MSN Search"
    

    如果改成用链接名称的方式写:

    I get 10 times more traffic from [Google][] than from
    [Yahoo][] or [MSN][].
    
      [google]: http://google.com/        "Google"
      [yahoo]:  http://search.yahoo.com/  "Yahoo Search"
      [msn]:    http://search.msn.com/    "MSN Search"
    

    图片

    Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

    行内式

    ![Alt text](/path/to/img.jpg)
    
    ![Alt text](/path/to/img.jpg "Optional title")
    

    ###参考式

    ![Alt text][id]
    
    「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
    
    [id]: url/to/image  "Optional title attribute"
    

    自动链接

    用尖括号将网址和电子邮件信箱包起来会自动转成链接。一般网址的链接文字就和链接地址一样,例如:

    <http://example.com/>
    

    Markdown 会转为:

    <a href="http://example.com/">http://example.com/</a>
    

    Referrence: http://wowubuntu.com/markdown/