美文网首页
MarkDown标记语言语法

MarkDown标记语言语法

作者: Tsung | 来源:发表于2013-05-22 09:02 被阅读111次

    PS(2016.04): 三年前最开始学习 markdown 的时候记录的笔记,最近在重新整理之前的笔记,再次翻起与 markdown 相关的一系列笔记,这里重新整理一下。

    基础语法规则

    行内文字格式化

    1. 加粗:用两个 * 包裹文字即可,粗体
    2. 斜体:用一个 * 包裹文字即可,斜体
    3. 粗斜体:用三个 * 包裹文字即可,粗斜体

    角注

    角注使用[^1]这种方式添加[1]。具体使用方式如下:

    引用角注[^1]
    
    [^1]: 角注内容
    

    图片和链接

    • 自动链接:<http://example.com/> 得到的是 http://example.com/
    • 带文字链接:[蘑菇街](http://www.mogujie.com) 得到的就是 蘑菇街

    向页面中插入图片的方式与带文字链接类似,只不过前面多了个感叹号:

    ![当图片出不来显示的文字](https://img.haomeiwen.com/i2283/476c245df0fe29fa.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    
    当图片出不来显示的文字

    图片上带链接?只要图片整体当文字然后用文字链接的方式就可以了。

    段落与换行

    在 HTML 页面中,段落使用 <p></p> 标签包裹,而换行则使用 <br />。在 Markdown 的语法中,段落直接使用空行隔开即可,而段内换行则是行最后跟两个空格,再换到下一行继续书写。示例如下:

    我是一段文字
    
    我是一段文字,但我下面还有段内换行文字  
    哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!
    

    我是一段文字

    我是一段文字,但我下面还有段内换行文字
    哈哈,我是段内换行的文字,你会发现上一行最后还有两个空格哦!

    标题

    标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。几级标题加几个 # 号。示例如下:

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

    注:不推荐无节制地加标题,每个项目最好提前约定好标题级数的使用规范。

    引用区块

    在 HTML 页面中,引用区块使用的是 blockquote 标签,Markdown 语法提供了一种更方便的方式,效果其实前面的中已经展现了,在要引用的段文字最前加 >即可。(如果有多段,则每一段最前都要加)

    > 我是引用内容
    >
    > 我也是引用内容
    

    我是引用内容

    我也是引用内容

    列表

    列表包括有序列表和无序列表,有序列表用数字开头,而无序列表使用 *-+ 开头,之后跟一个空格再添加内容,子列表需要相对父列表向右多两个空格且不能加空行。示例如下:

    无序列表:

     - 无序列表1
       + 无序子列表
     - 无序列表2
    
    • 无序列表1
      • 无序子列表
    • 无序列表2

    有序列表:(事实上,只要是数字就行,无需关注顺序,即便先写 2 再写 1 最终得到的也是按顺序排列的列表)

    2. 有序列表1
      a. 有序子列表
    1. 有序列表2
    
    1. 无序列表1
    • 无序
    1. 无序列表2

    如果列表之间加了空行,就会被解释成两段内容,也许得到的就并不是你想要的了。

    代码块

    代码块分两种,内联代码及块代码,对应于 HTML 中的 codepre 标签。内联代码很简单,用 ` 号(键盘上数字 1 左边那个键)包裹起来即可。而块代码则有两种方式:

    1. 使用三个 ` 来包裹代码块,这种方式可以自定义语法高亮

    2. 将代码块向右缩进四个空格,这种方式不会带任何语法高亮

       ```javascript
       console.log('hello world');
       ```    
      

    这时,你看到的效果会是:

    console.log('hello world');
    

    分隔线

    当一行元素为 * * * 的时候,就是下面这种效果的分隔线了:



    1. 角注

    相关文章

      网友评论

          本文标题:MarkDown标记语言语法

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