• Markdown基本语法


    最近无意中发现了一款轻量级的标记语言,语法简单,排版方便,正好最近想学习大数据与机器学习相关的知识,并计划时常写一些博客来做笔记,感觉Markdown应该是比较适合编辑,所以把博客园的编辑器改成了markdown,并在以后的记录中习惯使用。下面就总结一些Markdown的基本语法方便随时查阅。

    1.段落和换行

    段落中如果要强制换行,可以输入两个空格键加一个回车键实现。

    2.标题

    标题设置有两种方式
    第一种,标题前加 # 号表示,总共分为六级标题,建议在 # 号后加一个空格,这是最标准的Markdown语法。

    # 标题一
    ## 标题二
    ### 标题三
    #### 标题四
    ##### 标题五
    ###### 标题六    
    

    一级到六级演示效果分别如下:

    标题一

    标题二

    标题三

    标题四

    标题五
    标题六

    第二种,通过在文字下方添加 =-,他们分别表示一级标题和二级标题。(任何数量的 =- 效果相同)。

    标题一
    ======
    标题二
    ------
    

    效果分别如下:

    标题一

    标题二

    3.区块引用

    如果需要引用一小段别处的句子,那么就要用引用的格式。

    例如这样

    只需在文本前加入 > 这种尖括号(大于号)即可。
    区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >

    > 应用1
    > > 嵌套引用
    > 
    > 引用2	
    

    效果如下:

    引用1

    嵌套引用

    引用2

    4.粗体与斜体

    Markdown的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体和语法,用一个 * 包含一段文本就是斜体的语法。

    **这里是粗体** *这里是斜体*
    

    效果为:这里是粗体 这里是斜体

    5.列表

    Markdown支持有序列表无序列表
    无序列表只需在文字前加上星号、加号或是减号即可。

    * Red
    * Green
    * Blue
    

    等价于:

    + Red
    + Green
    + Blue
    

    也等价于:

    - Red
    - Green
    - Blue
    

    效果如下:

    • Red
    • Green
    • Blue

    有序列表则使用数字接着一个英文句点:

    1. Red
    2. Green
    3. Blue
    

    效果如下:

    1. Red
    2. Green
    3. Blue

    6.代码区块

    代码区块中的内容不会进行排版,而是按照原来的样子显示。在Markdown中代码区只要简单的缩进4个空格或者1个制表符就可以。

    这是一个普通段落:
    	
    	这是一个代码区块。
    

    7.分割线

    你可以在一行中用三个以上的星号、减号、底线来建立一个分割线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分割线:

    * * *
    ***
    *****
    - - -
    ——————————————————————————————————————————
    

    会产生两种效果的分割线,如下显示:



    ——————————————————————————————————————————

    8.链接

    Markdown中有两种方式实现链接,分别为内联方式引用方式。不管是哪一种,链接文字都是用 [方括号] 来标记。

    内联方式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可:

    This is [an example](http://example.com/ "Title") inline link.
    [This link](http://example.net/) has no title attribute.
    

    效果如下:
    This is an example inline link.
    This link has no title attribute.

    如果你是要链接到同样主机的资源,你可以使用相对路径:

    See my [About](/about/) page for details.
    

    引用方式链接,使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签:

    This is [an example][id] reference-style link.
    

    也可以选择性地在两个方括号中间加上空白:

    This is [an example] [id] reference-style link.
    

    接着,在文档的任意处,可以把这个标签的链接内容定义出来:

    [id]: http://example.com/  "Optional Title Here"
    

    链接定义的形式为:

    • 方括号,里面输入链接的辨识用标签
    • 接着一个冒号
    • 接着一个以上的空白或 tab
    • 接着链接的网址
    • 选择性地接着 title 内容,可以用单引号、双引号或是括号包着

    下面这三种链接的定义都是相同:

    [foo]: http://example.com/  "Optional Title Here"	
    [foo]: http://example.com/  'Optional Title Here'
    [foo]: http://example.com/  (Optional Title Here)
    

    网址定义只有在产生链接的时候用到,并不会直接出现在文档之中。
    示例:

    I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].
    [1]: http://google.com/        "Google" 
    [2]: http://search.yahoo.com/  "Yahoo Search" 
    [3]: http://search.msn.com/    "MSN Search"
    

    效果如下:
    I get 10 times more traffic from Google than from Yahoo or MSN.

    9.程序代码

    如果要标记一小段行内程序代码,可以用反引号把它包起来(`),例如:

    Use the `printf()` function.
    

    效果为: Use the printf() function.
    如果要在程序代码区段内插入反引号,可以用多个反引号来开启和结束程序代码区段:

    ``There is a literal backtick (`) here.``
    `` There is a literal backtick (`) here. ``
    

    效果为:There is a literal backtick (`) here.

    10.图片

    Markdown图片的语法和链接很相似,也分别为内联方式引用方式
    内联方式图片的语法看起来像是:

    ![Alt text](/path/to/img.jpg)
    
    ![Alt text](/path/to/img.jpg "Optional title")
    

    详细叙述如下:

    • 一个惊叹号 !
    • 接着一个方括号,里面放上图片的替换文字
    • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。

    引用方式图片语法类似这样:

    ![Alt text][id]
    

    「id」是图片参考的名称,图片参考的定义方式则和链接参考一样:

    [id]: url/to/image  "Optional title attribute"
    

    11.自动链接

    Markdown 支持比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接,链接的文字就和链接位置一样,例如:

    <http://example.com/>
    

    效果为: http://example.com/

    12.转义字符

    Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),可以在星号的前面加上反斜杠:

    \*literal asterisks\*
    

    Markdown 支持在下面这些符号前面加上反斜杠来帮助插入普通的符号:

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

    编辑器

    本人使用的是Window系统,所以选择了MarkdownPad

    参考文献

    http://daringfireball.net/projects/markdown/basics
    http://www.cnblogs.com/hnrainll/p/3514637.html
    http://www.ituring.com.cn/article/504
    http://www.jianshu.com/p/1e402922ee32/

    建议

    建议初次接触Markdown语法的同学,可以像我这样在学习的过程中尝试写一个符合自己查阅习惯的总结,在总结完成以后,也就熟悉了Markdown语法的使用。本篇博客是用Markdown所写,文章最后会给出源文件下载地址,希望想学习的同学可以作为一个参考。

    附件下载

  • 相关阅读:
    Python:dict用法
    Ubuntu无法识别显示器情况下,高分辨率的设置
    select节点clone全解析
    js控制frameset的rows
    jQuery中事情的动态绑定 (转)
    jQuery动态添加表格1
    使用ajax,后台传回的数据处理
    Spring Boot 之构建Hello Word项目
    linux防火墙基本操作
    Vmware虚拟机中安装cnetOS7详细图解步骤
  • 原文地址:https://www.cnblogs.com/jinhaolin/p/5772103.html
Copyright © 2020-2023  润新知