美文网首页互联网+
Markdown语法介绍

Markdown语法介绍

作者: IrisZL | 来源:发表于2017-03-28 18:14 被阅读38次

    虽然Markdown的语法已经足够的简单和容易,但是在不经常使用的情况下,还是会记不住具体的语法,本文主要对Markdown常用的一些语法进行简单的罗列,以期望下次忘记的时候可以快速的进行查阅。
    Markdown的目标是实现[简单易读]。 Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。

    一 区块元素

    1 段落和换行

    一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

    2 标题

    (1)使用底线的模式
    使用 “=” 来标识最高阶标题
    例:一级标题
    =======

    (2)在文字之前使用 1到6 个 “#” 来标识标题 1个代表最高阶标题,一次往下递减
    例如:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

    3 区块引用 Blockquotes

    Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。

    这是一个区块引用
    这是一个区块内的引用
    在同一个地方多次使用 ">" 就会引用在同一个区块中

    Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

    空山新雨后,
    天气晚来秋,

    区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :

    我是最外层的应用

    我是加了两层的引用

    我是加了第三层的引用,多加几个 > 引用就会越往里

    引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

    我是一个在引用内的标题 我的格式是 “ > ### ”

    4 列表

    Markdown 支持有序列表和无序列表。
    无序列表使用星号、加号或是减号作为列表标记:
    (1)"+"号的无序列表(格式:"+ 想显示的文字")

    • 红色
    • 蓝色
    • 黄色
      (2)""号的无序列表(格式 : " 想显示的文字")
    • 红色
    • 蓝色
    • 黄色
      (3)"-"号的无序列表(格式:"-" 想显示的文字)
    • 红色
    • 蓝色
    • 黄色
      以上三种格式最终显示出来的效果是一致的,所以可以根据自己的喜好选择对应的编写

    有序列表则使用数字接着一个英文句点:(格式: “x. 想显示的文字” )

    1. red
    2. blue
    3. yeallow

    如果要在列表项目内放进引用,那 > 就需要缩进:

    • 颜色

    蓝色
    黄色
    蓝色

    如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:

    • 这是一个代码区块:
      <代码可以写在这里>

    5 代码区块

    要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如:
    这是一个段落
    这是一个代码区块
    这是代码区块

    6 分割线

    你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
    以下是创建分割线的各种方式:
    ******
    -----
    * * *
    ________


    一 区段元素

    1 链接

    Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
    不管是哪一种,链接文字都是用 [方括号] 来标记。(格式:" [链接中文名字] (链接英文名字) " 注:方括号与圆括号之间不能存在空格)

    我的github链接地址

    2 强调

    Markdown 使用星号""和底线"_"作为标记强调字词的符号.(格式: “ 要强调的内容 *”)

    这是使用星号要强调的内容

    这是使用底线强调的内容

    唯一的限制是,你用什么符号开启标签,就要用什么符号结束。

    3 代码

    如果要标记一小段行内代码,你可以用反引号把它包起来(`)
    例如: 如下的内容包含了一个 'printf()'的代码段

    4 图片

        格式:(![图片名称] (图片地址)) 注:方括号与圆括号之间在写的时候是没有空格的,这里只是为了能展示出来,所以添加了对应的空格.
    

    例:
    唯美图片

    如果是想直接显示图片的话,在简书中有插入图片的输入,可直接插入一张图片。

    4 反斜杠

    Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号.

    至此,一篇简单的文档就可以使用Markdown来编写完成的。当然这些只是简单浅显的利用,还有许多Markdown的功能未能罗列。可参考具体的Markdown使用文档

    相关文章

      网友评论

        本文标题:Markdown语法介绍

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