Markdown基础语法总结

目录

  • 区块元素
    • 标题

    • 列表

    • 区块引用

    • 代码区块

    • 分隔线

    • 段落和换行

  • 区段元素
    • 链接

    • 强调

    • 代码

    • 图片

    • 转义


  1. 标题 <a name="title"></a>

    • 类Setext

      This is an H1

      This is an H2

        Code:
      
        This is an H1   
        ====
        This is an H2
        ----
      

      备注:任何数量的=和-都可以有效果

      =表示最高阶标题,-表示第二阶标题

    • atx形式

      This is an H1

      This is an H2

      This is an H3

      This is an H4

      This is an H5
      This is an H6
        Code:
      
        # This is an H1
      
        ## This is an H2
      
        ### This is an H3
      
        #### This is an H4
      
        ##### This is an H5
      
        ###### This is an H6 
      

      也可以表示成这样 # This is an H1 #
      备注: 行首n个#表示n阶标题,n最大为6

  2. 列表

    • 有序列表

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

      1. Bird
      2. McHale
          Code:
          1. Bird
          2. McHale
      
    • 无序列表

      无序列表是使用,+,-中任意一种来表示

      • Red
      • Green
      • Blue
          Code:
          - Red
          + Green
          * Blue
      
  3. 引用

    区块引用是使用类似email中用>来表示

    示例

     > 简单引用1
     > 简单引用2
     > 
     > 多行引用
     >> 嵌套引用
    
     > ## 引用中使用Markdown语法。
     > 
     > 1.   这是第一行列表项。
     > 2.   这是第二行列表项。
     > 
     > 给出一些例子代码:
     > 
     >     return shell_exec("echo $input | $markdown_script");
    

    效果

    简单引用1
    简单引用2

    多行引用

    嵌套引用

    引用中使用Markdown语法。

    1. 这是第一行列表项。
    2. 这是第二行列表项。

    给出一些例子代码:

      return shell_exec("echo $input | $markdown_script");
    
  4. 代码区块

    建立代码区块,只需要简单地缩进4个空格或是1个制表符就可以
    代码块一直持续到没有缩进的那一行(或是文件的结尾)

    也可以使用` 来表示

     代码块
    
     使用缩进表示代码块
    
  5. 分隔线

    一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西,
    也可以在星号或是减号中间插入空格


     ---
    

     - - -
    

     ***
    

     * * *
    

     ——————————————
    
  6. 段落和换行

    • 段落

      段落是由一个或多个连续的文本行组成,
      它的前后要一个以上的空行(显示上看起来像是空的)

    • 换行

      Mardown允许段落内的强迫换行(插入换行符)
      要依赖Markdown来插入<br/>标签的话,在<br/>插入处要先按入两个以上的空格然后回车

  7. 链接

    支持两种形式的连接语法: 行内式参考式
    链接字符不区分大小写

    • 行内式

      This is baidu
      baidu

        Code:
        This is [baidu](http://www.baidu.com/ "度娘")
        [baidu](https://www.baidu.com/)
      
    • 参考式

      This is baidu example reference-style link.

        Code:
        This is [baidu example][id] reference-style link.
        标记: [id]: https://www.baidu.com/ "度娘"
        或者: [id]: https://www.baidu.com/ '度娘' (简书不支持)
        或者 [id]: https://www.baidu.com/ (度娘)
        (简书不支持使用对文本描述使用单引号)
      
    • 隐式链接标记功能

      Baidu

        Code:
        [Baidu][]
        标记可以这样写: [Baidu]: http://baidu.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"
         (备注: 上述代码在使用时需删掉前面的--)          
    
  8. 强调

    Markdown使用性星号(*)和底线(_)作为标记强调字词的符号
    两端被一个*或_包围的单词会被转换成斜体
    两端被两个*或_包围的单词会被转换成粗体
    *或_的两端不能有空白
    用什么符号就以什么符号结尾

     示例
     *斜体*
     _斜体_
     **粗体**
     __粗体__
    
  9. 代码

    如果要标记一段行内代码,可以用反引号 ` 把它包起来
    用多个反引号来开启和结束代码区段

    行内
    段落代码
    包含`反引号
    包含 `两个反引号`
    <特殊符号&>

     示例:
    
     ``段落代码``  
     ``包含`反引号``
     ``包含 `两个反引号` `` 
     ``<特殊符号&>``
    
  10. 图片
    Markdown使用一种和链接很相似的语法来标记图片
    允许两种样式:行内式和参考式

    • 行内式的图片语法:

      Overload 仓助
      Overload 仓助
        示例
          ![Overload 仓助](http://img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png   ) 
          ![Overload 仓助](http://img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png "森林贤王") 
      
    • 参考式语法:

      Overload 仓助
      Overload 仓助
        示例:
          -- ![Overload 仓助][xd]  
          -- [xd]:img4.duitang.com/uploads/item/201508/19/20150819131018_vYPyR.thumb.224_0.png  "森林贤王"
         (备注: 上述代码在使用时需删掉前面的--) 
      
  11. 转义

    使用反斜杠来插入一些在语法中有其它意义的符号,如*
    需要转义的字符:

    \   反斜线
    `   反引号
    *   星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    #   井字号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号
    


作者:风清723
链接:http://www.jianshu.com/p/075d7cac8fef
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
posted @ 2017-02-07 14:07  一目之秋  阅读(112)  评论(0编辑  收藏  举报