zoukankan      html  css  js  c++  java
  • Markdown 语法备注

    Markdown(简称MD)是一种轻量级的标记语言。MD语法受到一些既有 Text-to-HTML 格式的影响,包括Setext、atx、Textile、reStructuredText、Grutatext 和 EtText,而最大灵感来源其实是纯文本电子邮件的格式。

    其语法都常用的符号组成,特定的符号约定对应特定的HTML元素标记,能实现特定的文本格式

    值得注意的是,在MarkdownPad(简称MDP)等MD编辑器中,能一键(F6)生成HTML文件,并能通过修改CSS,自定义个性化的格式表现,因而MP也是博客编辑的利器!

    MD是一种文本书写的格式,因而其格式语法主要涉及常用的HTML文本元素,如h1~h6,p,strong,em,pre,code,blockquote,ol,ul,li等。当然,也包括a链接,图片链接及电邮链接等链接语法。下文将简略罗列MD常用语法:

    区块元素

    1. 标题

    Markdown 支持两种标题的语法,类 Setext 和类 atx 形式:前者使用不限量的 === 和 ---,即分别在文本下一行划入===或---生成最高阶标题(h1)和第二阶标题(h2);后者使用不同数量的符号 # 衔接文本,生成h1~h6的标题。

    这是标题h1  
    ================  
    这是标题h2  
    ------------------ 
    ### 这是标题h3  
    ###### 这是标题h6  
    

    2. 段落,换行,加粗,斜体

    段落:常规输入生成p标签;
    换行:行尾空两格或tab缩进生成br标签;
    加粗:单个 * 或 _ 开头,衔接文本,对应的 * 或 _ 结尾;
    斜体:一对 * 或 _ 开头,衔接文本,对应的一对 * 或 _ 结尾;

    注意:如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号;也可通过"\"转义,让*和\作为普通字符。

    这是普通文本。  <p>这是普通文本。</p>
    **这是粗体**   <strong>这是粗体</strong>
    **这是斜体**   <em>这是斜体</em>  

    3. 引用,代码块,分割线

    引用:在每行或段落前面添加">"符号即可,MD会自动为文本添加blockquote标签;引用可嵌套,即可在">"里面再输入">"生成引用块内的引用;引用块内可以使用其他的MD语法,如标题,列表,行内文本表现标识等。

    > 这是一个引用块;
    > 也可以这样写,
    断行可以不用添加">"符号;
    >>这是子引用。  
    

    代码块:缩进4个空格或一个tab制表符就能生成代码块,MD会用\<pre\>和\<code\>标签来把代码区块包起来。只要某一行未缩进,文本就变成普通的文本行。

    这是一个标准的代码块,由pre包裹code组合而成。
    

    注意:在代码区块中,一般的MD语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

    分割线:用三个以上的星号(*)、减号(-)、底线( _ )来建立一个分隔线,行内不能有其他东西;也可以在星号或是减号中间插入空格。

    ***  
    * * *  
    *******  
    - - -
    ----------------------  
    

    4. 列表

    无序列表:使用星号(*)、加号(+)或减号(-)作为列表标记,标记类型为实心原点。

    有序列表:使用数字+英文句点+空格作为列表标记。注意:在列表标记上使用的数字并不会影响输出的 HTML 结果,数值可相同也可不连续

    *   列表1
    *   列表2
    *   列表3  
    
    1.  列表1
    3.  列表2
    2.  列表3  

    区段元素

    1. 链接

    MD支持两种形式的链接语法:行内式和参考式两种形式。不管是哪一种,链接文字都是用 [方括号] 来标记。

    行内式格式:在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可。即:[链接文本](链接网址 "title");

    参考式格式:在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记。即:[链接文本][id值];[id值]:链接网址 "title";

    [百度](http://www.baidu.com/)  
    [百度][baidu];[baidu]:http://www.baidu.com "这是百度的链接"  
    

    注意:id可以有字母、数字、空白和标点符号,但是并不区分大小写;参考式可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,如:[baidu][];[baidu]:http://www.baidu.com

    2. 图片

    MD使用一种和链接很相似的语法来标记图片,同样也允许两种样式:行内式和参考式。目前还无法为图片设置宽高!

    行内式:![图片替代文本](图片地址 "title")

    参考式:![alt 图片替代文本][id]; [id]:图片地址 "title"


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

  • 相关阅读:
    【前端学习笔记】函数柯里化(自网易云课堂)
    【前端学习笔记】call、apply、bind方法
    【前端学习笔记】arguments相关
    【前端学习笔记】函数定义、函数调用、this
    【前端学习笔记】闭包的作用及案例
    【前端学习笔记】利用iframe实现表单的无刷新提交案例
    【前端学习笔记】JavaScript 常用方法兼容性封装
    【前端学习笔记】JavaScript 小案例合集
    【前端学习笔记】JavaScript JSON对象相关操作
    牛客多校第10场J Wood Processing 分治优化/斜率优化 DP
  • 原文地址:https://www.cnblogs.com/mimifeng/p/3360881.html
Copyright © 2011-2022 走看看