• Markdown语法学习(二)


    概述

    宗旨

    Markdown 的目标是实现「易读易写」。

    可读性,无论如何,都是最重要的。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响,包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。

    总之, Markdown 的语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像强调。Markdown 的列表看起来,嗯,就是列表。Markdown 的区块引用看起来就真的像是引用一段文字,就像你曾在电子邮件中见过的那样。

    兼容 HTML

    Markdown语法的目标是:成为一种适用于网络的书写语言。

    Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

    不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。

    区块语法

    段落

    Markdown中的段落需要使用一个以上的空行,否则不会认为是单独一个段落。

    标题

    Markdown支持两种格式标题形式:
    类Setext形式使用底线形式,=表示顶级标题,-表示第二级标题。

    顶级标题
    =======
    二级标题
    -------
    

    用Markdown处理之后,效果如下:

    顶级标题

    二级标题

    类Atx形式,在行首插入多个#,表示标题级数(支持六级),如下的语法形式:

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

    最终转化之后效果是这样的:

    一级标题

    二级标题

    三级标题

    四级标题

    区块引用

    使用字符">"(大于号),后面跟着一个空格,表示一个区块引用。
    比如下面这种语法

    > 区块引用测试
    

    转换之后的效果如下

    区块引用测试

    区块引用是可以自身嵌套的,可以使用其他的 Markdown 语法,包括标题、列表、代码区块等。
    比如下面的效果,可以用嵌套实现

    这是一个嵌套标题

    这是区块引用自身嵌套

    • 这是列表项

    下面是嵌入代码
    // c++ code
    int value = 12345;

    列表

    无序列表可以使用 星号*、加号+、减号-,作为标记。有序列表使用数字加一个点号。下面的语法描述

    * Red
    + Green
    - Blue
    - 
    下面是有序列表
    
    1. 小鸟
    2. 大象
    

    转换之后的语法

    • Red
    • Green
    • Blue

    下面是有序列表

    1. 小鸟
    2. 大象

    代码区块

    代码区块使用四个空格或一个Tab表示。通常这些区块我们并不希望它以一般段落文件的方式去排版,而是照原来的样子显示。比如下面的输入(正常输入前面加上四个空格缩进对齐):

    sum = 0
    for i=0, i < 100, ++i
    	sum += i
    end for
    

    分割线

    可以在一行中使用三个以上的星号*、减号-、下划线表示分割线。比如下面两行:

    ***
    ---
    

    实际显示效果是这样的:



    区段元素

    行内链接

    链接的文字使用[方括号]来标记。提示信息可以用双引号包含。

    This is [an test](http://test "help")
    

    转换之后是这样的:

    This is an test

    强调

    Markdown使用星号*、和下划线_,作为强调字符。
    单个字符包围的表示斜体,两个字符包围的表示黑体。

    *italic* _italic_
    **bold** __bold__
    

    实际显示效果

    italic italic

    bold bold

    代码

    Markdown支持行内代码。使用反引号`(左上角数字键1左边对应的字符)。比如下面形式:

    Use `printf()` function
    

    显示为

    Use printf() function

    自动链接和转移字符

    自动链接,在名字和url一致的时候,可以用下面形式:

    <http://www.help.com/>
    

    显示效果

    http://www.help.com/

    Markdown支持转移字符,使用反斜杠作为转移符。比如可以使用转移字符输出markdown中使用的关键字符。

    • 反斜线
    • ` 反引号
      • 星号
    • _ 底线
    • {} 花括号
    • [] 方括号
    • () 括弧
    • 井字号

      • 加号
      • 减号
    • . 英文句点
    • ! 惊叹号

    可以尝试下:
    这里输出中括号[4]。

    附加说明

    本文是使用Markdown编写的语法学习总结。内容中用到比较多的是代码区块和区块引用,主要是为了表示原始的语法格式和Markdown转换之后的效果对比。

    参考

    [1] Markdown 语法说明

    看完效果

    不得不吐槽下,博客园的markdown效果真的太差。完全没法看出来优势。

  • 相关阅读:
    时间戳转换
    DIV背景半透明文字不半透明的样式
    转 JavaScript中判断对象类型的种种方法
    AllJoyn 了解
    Oracle 跨库 查询 复制表数据
    SQL Server 跨数据库查询
    Jersey RESTful Web服务
    【项目管理】项目启动阶段 -- 制定项目章程
    多项目同时进行如何做好进度管理?
    svn版本管理
  • 原文地址:https://www.cnblogs.com/tocy/p/Markdown-intro-2.html
Copyright © 2020-2023  润新知