Markdown 语法入门

作者: Burjal | 来源:发表于2017-03-15 10:23 被阅读556次
    Markdown

    Markdown作为一种使用普通文本编辑器编写的标记语言,通过简单的标记语法,设置文本不同的格式。以实现 [易读易写] 的目标。

    Markdown为编写HTML提供了很好的实现,并避免了伴随的复杂性和丑陋难看。Markdown的语法全由一些符号组成,语法简单易上手。

    本文介绍Markdown语法入门。

    一、语法介绍

    1.1 标题

    1.1.1 Setext形式

    类Setext形式是用底线的形式,利用 = (最高阶标题) 和 - (第二阶标题),例如:

    This is H1
    ===========
    This is H2
    -------------------
    

    This is H1

    This is H2

    注意:其中,任何数量的 =- 都是等效的。

    1.1.2 Atx形式

    类Atx形式是在行首插入 1 到 6个 #,对应分别为标题 16 阶,例如:

    # H1 #
    ## H2 ##
    ### H3 ###
    #### H4 ####
    ##### H5 #####
    ##### H6 #####
    

    H1

    H2

    H3

    H4

    H5
    H6

    通常,若为了美观用,可以在行尾加上 #,行尾的 # 不强制要求和开头一样,只有行首的字符数确定标题对应的阶数。

    1.2 区块引用Blockquotes

    Markdown 标记区块引用类似email中用 > 的引用方式。在每行的前面加上 >
    同样,Markdown允许只在整个段落的第一行最前加上 >
    区块引用也可以嵌套,根据不同层次加上不同数量的 > 即可。
    引用的区块内同样可以使用其他Markdown 语法,包括标题,列表,代码区块等

    > 区块引用...
    >
    > 区块引用...
    
    > 段落只需要要在第一行加上 
    整个段落即引用在区块内。
    
    > 区块间引用
    >> 区块间引用
    
    > ### 引用其他语法
    

    区块引用...

    区块引用...

    段落只需要要在第一行加上
    整个段落即引用在区块内。

    区块间引用

    区块间引用

    引用其他语法

    1.3 列表

    Markdown支持有序列表和无序列表。

    1.3.1 有序列表

    有序列表使用1.数字接着一个英文句点;特别注意的是在标记上使用的数字并不会影响输出结果;列表项还可以包含多个段落,每个列表下段落都必须缩进4个空格或者1个制表符;如果需要在列表项目内引用的时候,使用 > 需要缩进。例如如下语法:

    1.   item 1
    3.   item 2(标记上使用的数字并不会影响输出结果)
    2.   item 3(标记上使用的数字并不会影响输出结果)
    4.   item 4
          多段文字1
          多段文字1
          >区块引用
    5.  item 5
        1.列表项目内加列表
    
    1. item 1
    1. item 2(标记上使用的数字并不会影响输出结果)
    2. item 3(标记上使用的数字并不会影响输出结果)
    3. item 4
      多段文字1
      多段文字1

      区块引用

    4. item 5
      1.列表项目内加列表

    1.3.2 无序列表

    无序列表使用 *(星号)、+(加好) 以及 -(减号)作为列表标记:

    - item 1
    + item 2
    * item 3
      - item 3.1
        - item 3.1.1
    
    • item 1
    • item 2
    • item 3
      • item 3.1
        • item 3.1.1

    1.4 代码区块

    和程序相关的写作通常会用到代码区块,如果用区块引用排版就会和代码排版有差异,而我们更希望是按照原来的样子显示。Markdown 通过 <code>`</code> 和 <code>```</code> 标签来把代码区块包起来。

    在代码区块里, &<>会自动转换成HTML试题,这样让诸如插入范例使用的HTML原始码更方便了。

     <div class="footer">
            © 2004 Foo Corporation
     </div>
    

    在代码区块中,一般的Markdown语法不会被转换,因此可以很容易的用Markdown语法撰写相关语法文档。

    1.5 分割线

    在任意一行中用三个以上的 *-以及_来建立分割线,行内不能有除空格外的其他内容。

    1.6 特殊格式

    1.6.1 粗体

    粗体文字设置使用 **将目标文字包含起来。

    Bold

    1.6.2 斜体

    斜体文字设置使用 _将目标文字包含起来。

    Italics

    1.6.3 删除线

    斜体文字设置使用 ~~ 将目标文字包含起来。

    strikethrough

    1.6.4 语法高亮

    特定语法用如<code>```js</code>将设置超链接的文字包含起来。

    grunt.initConfig({
      assemble: {
        options: {
          assets: 'docs/assets',
          data: 'src/data/*.{json,yml}',
          helpers: 'src/custom-helpers.js',
          partials: ['src/partials/**/*.{hbs,md}']
        },
        pages: {
          options: {
            layout: 'default.hbs'
          },
          files: {
            './': ['src/templates/pages/index.hbs']
          }
        }
      }
    };
    

    1.7 表格

    1.7.1 普通表格

    表格通过 |-表示。表头需要和表内容用 - 分割,各列内容用 | 分割。注意,不需要垂直对齐。

    |table1|table2|
    |--------|-------|
    |content1|content2|
    
    table1 table2
    content1 content2

    1.7.1 特殊格式表格

    在表头内容分割线结束加上 : 即表示文字靠右对齐。

    |table1|table2|
    |--------:|-------:|
    |content1|content2|
    
    table1 table2
    content1 content2

    1.8 超链接

    超链接通过 [ 超链接文字 ] 包含超链接文字内容,并在后紧跟 (URL) 超链接地址。

    [Link](http://www.jianshu.com/u/7f8d85055cd1)
    

    当需要为超链接添加hover效果的时候,在 (URL "hoverTitle") URL后用 "" 将提示文字包含起来。

    [Link](http://www.jianshu.com/u/7f8d85055cd1 "Burjal")
    

    1.9 Named Anchors

    Named Anchors使能够在相同的页面上跳转到指定的锚点。最常用的就是跳转到每一个章节。

    # Table of Contents
      * [Chapter 1](#chapter-1)
      * [Chapter 2](#chapter-2)
      * [Chapter 3](#chapter-3)
    

    Table of Contents

    上述会跳转到对应如下位置:

    ## Chapter 1 <a id="chapter-1"></a>
    Content for chapter one.
    
    ## Chapter 2 <a id="chapter-2"></a>
    Content for chapter one.
    
    ## Chapter 3 <a id="chapter-3"></a>
    Content for chapter one.
    

    1.20 图片

    图片的语法和超链接的语法类似,在超链接语法前加了 !

    ![Markdown](https://img.haomeiwen.com/i311578/26c2869134c4e359.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    
    Markdown

    二、简书设置默认编辑器:

    简书已经支持Markdown语法编辑。
    设置步骤如下:

    设置

    在首页找到并进入设置。

    设置常用编辑器

    将常用编辑器设置为 Markdown

    Markdown 语法入门分析到此就结束了~

    附:

    Grav SYNTAX

    Markdown 语法说明 (简体中文版)

    Markdown: Basics(快速入门)

    相关文章

      网友评论

        本文标题:Markdown 语法入门

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