Markdown基础语法总结

时间:2024-08-31 15:36:50

目录

  • 区块元素
    • 标题

    • 列表

    • 区块引用

    • 代码区块

    • 分隔线

    • 段落和换行

  • 区段元素
    • 链接

    • 强调

    • 代码

    • 图片

    • 转义


  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使用一种和链接很相似的语法来标记图片
    允许两种样式:行内式和参考式

    • 行内式的图片语法:

      Markdown基础语法总结
      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 "森林贤王")
    • 参考式语法:

      Markdown基础语法总结
      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
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。