MarkDown语法

作者: DancewithPeng | 来源:发表于2017-01-09 18:58 被阅读0次

    内容包含

    • 区块元素
      1. 段落和换行
      2. 标题
      3. 区块引用
      4. 列表
      5. 代码区块
      6. 分隔线
    • 区段元素
      1. 链接
      2. 强调
      3. 代码
      4. 图片
    • 其他
      1. 自动链接
      2. 反斜杠

    区块元素

    段落和换行


    段落之间需要有一个或者多个空行来分隔

    这里就是第二段
    第二段
    段内换行,需要两个空格加一个回车

    标题


    用 # 号来处理表示 H1
    两个 # 号来表示 H2
    以此类推, 如

    # 一级标题
    ## 二级标题
    ### 三级标题
    

    显示如下:

    一级标题

    二级标题

    三级标题

    区块引用


    引用一个区块,用 > 来表示

    > 这里是区块引用的内容
    

    效果如下:

    这里是区块引用的内容

    区块引用可以嵌套,如

    > 这里是外层引用
    >> 内层引用多加一个 > 符号
    >>> 再内层
    

    效果如下:

    这里是外层引用

    内层引用多加一个 > 符号

    再内层

    列表


    列表分为 无序列表有序列表

    无序列表

    无序列表是在文本前加 * 号

    * 无序列表项1
    * 无序列表项2
    * 无序列表项3
    * 无序列表项4
    

    效果如下:

    • 无序列表项1
    • 无序列表项2
    • 无序列表项3
    • 无序列表项4
    有序列表

    有序列表是在文本前加 1. 2. 3.
    如:

    1. 有序列表项1
    2. 有序列表项2
    3. 有序列表项3
    4. 有序列表项4
    

    效果如下:

    1. 有序列表项1
    2. 有序列表项2
    3. 有序列表项3
    4. 有序列表项4

    代码区块


    代码区块是在文本后空一行,在缩进4个空格

    这里就是代码区块
    代码区块里的文本不会解析MarkDown语法,如 *没有强调效果*
    ## 没有标题效果
    

    代码区块在没有缩进的文本时就结束了

    分隔线


    以下方法都可以表示分隔线

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

    区段元素

    链接


    链接分为行内式和参考式两种

    行内式

    用 [] 把需要链接的文本包含起来,然后在其后面用小括号包含URL

    百度的首页:[百度](https://www.baidu.com)
    

    效果如下:
    百度的首页: 百度

    参考式

    参考式先用 [文本][资源id] 的形式占位,然后在其他地方指定URL,后面的 资源id 可以省略,会把文本当做id

    百度的首页: [百度][baidu] 或 [百度][]
    在其他空白的地方定义百度的URL,形如
    [baidu]: https://www.baidu.com "百度首页"
    [百度]: https://www.baidu.com "百度首页"
    后面的字符串只是一个描述
    

    效果如下
    百度的首页: 百度baidu
    百度的首页: 百度

    强调


    用 一对 ** 符号 或者 __ 符号把需要强调的词包含起来

    这里有一个 *重要的会议* ,请_准时_参加
    

    效果如下
    这里有一个重要的会议,请 准时 参加

    代码


    段落中的代码

    在一段文本段落中,用一对 ` 号把代码包含起来

    在Swift语言中,打印函数是`print()`
    如打印Hello World! 就这样 `print("Hello World!")`
    

    效果如下
    在Swift语言中,打印函数是print()
    如打印Hello World! 就这样 print("Hello World!")

    一段代码

    如果要单独引入一段代码,可以用一对三个 ` 符号把一段代码包含在内

    ```Swift // 这里可以语法高亮的语言
    // 这里用for循环打印10次Hello World!
    for _ in 1...10 {
        print("Hello World!")
    }
    ```
    

    效果如下

        // 这里用for循环打印10次Hello World!
        for _ in 1...10 {
            print("Hello World!")
        }
    

    图片


    引入图片也有行内式和参考式两种,目前MarkDown还没有指定图片宽高的方法,如果需要用<img>标签

    行内式

    和链接类似,只是在链接的形式前加了个 ! 号

    ![猫咪](https://img.haomeiwen.com/i4300331/91f2633dc312cf64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)  
    ![狗狗](https://img.haomeiwen.com/i4300331/d9174e22144e9505.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)       
    

    效果如下

    猫咪
    狗狗
    参考式

    参考式和链接类似,也可以先占位,然后在其他地方指定图片的URL

    // 后面的括号指定ID
    ![Cat][catURL]
    ![Dog][dogURL]
    // 也可以把简写ID,会把文本当成ID
    ![Cat2][]
    ![Dog2][]
    
    // 在其他位置指定id的对应的URL
    [catURL]: https://img.haomeiwen.com/i4300331/91f2633dc312cf64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
    [dogURL]: https://img.haomeiwen.com/i4300331/d9174e22144e9505.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
    [Cat2]: https://img.haomeiwen.com/i4300331/91f2633dc312cf64.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
    [Dog2]: https://img.haomeiwen.com/i4300331/d9174e22144e9505.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
    

    效果如下

    Cat
    Dog
    Cat2
    Dog2

    其他

    自动链接


    MarkDown支持用简短的形式来表示网址和邮箱,只需要用<>把网址和邮箱地址包含起来

    百度地址<https://www.baidu.com>
    给我发邮件<dancewithpeng@gmail.com>
    

    效果如下
    百度地址https://www.baidu.com
    给我发邮件dancewithpeng@gmail.com

    反斜杠


    可以用反斜杠在MarkDown文档中表示的字符

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

    相关文章

      网友评论

        本文标题:MarkDown语法

        本文链接:https://www.haomeiwen.com/subject/ytphbttx.html