• MarkDown基础语法大全


    一、MarkDown是什么?

      Markdown是一种轻量级的「标记语言」,创始人为约翰·格鲁伯,用简洁的语法代替排版,目前被越来越多的知识工作者、写作爱好者、程序员或研究员广泛使用。其常用的标记符号不超过十个,相对于更为复杂的 HTML 标记语言来说,Markdown 十分的轻量,学习成本也不需要太多,且一旦熟悉这种语法规则,会有沉浸式编辑的效果。Markdown的语法简洁明了、学习容易,而且功能比纯文本更强,因此有很多人用它写博客,Markdown文件后缀为.md。

    二、MarkDown标记语言的优缺点

    优点:

      1、专注文字内容而不是排版样式,安心写作;

      2、轻松的导出 HTML、PDF 和本身的 .md 文件;

      3、纯文本内容,兼容所有的文本编辑器与字处理软件;

      4、随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱;

      5、可读、直观、学习成本低。

    缺点:

      1、没有像word一样格式的花哨;

      2、有太多不兼容的方言。由于原始的Markdown支持的格式有限,所以出现了很多不同的扩展,这些扩展之间的不兼容性是一个问题;

      3、markdown没有被标准化,其版本较多,给人感觉有点混乱,因为github的关系,当前比较流行的是markdown是gfm;

      4、有些平台不支持Markdown编辑模式。

    三、MarkDown基础语法

    (1)标题

      用法:只需要在标题文字前加上‘#’号,‘#’号个数代表标题级数,级数上限为6级;

      语法示例:

    # 一级标题

    ## 二级标题

    ### 三级标题

    #### 四级标题

    ##### 五级标题

    ###### 六级标题

    (使用工具为印象笔记,左边为MarkDown语法语句,右边为效果)

      注意:标准语法中‘#’号和文字之间有一个空格,但在简书上,空格可以省略。

     

    (2)文本

      ①文本加粗

      用法:分别用‘**’号把要加粗的文字两边包起来

      语法示例:

     文字内容

    **加粗文字内容**

      ②斜体

      用法:分别用‘*’号把要倾斜的文字两边包起来

      语法示例:

    文字内容

    *斜体文字内容*

      ③加粗斜体

      用法:其实就是字体倾斜+加粗,分别用‘***’号把要倾斜加粗的文字两边包起来

      语法示例:

     文字内容

    ***斜体加粗文字内容***

      ④下划线

      用法:使用标签<u></u>把要添加下划线文字两边包起来

      语法示例:

    <u>文字内容</u>

      ⑤删除线

      用法:分别用‘~~’号把要删除的文字两边包起来

      语法示例:

    ~~删除文字内容~~

     

     

      ⑤分割线

      用法:在要分割的地方使用至少3个连续‘*’或‘-’即可分割,多于3个也可以

      语法示例:

     分割文字内容

    ***

    ---

     

     

    (3)引用

      用法:在引用文字前加‘>’号

      语法示例:

     >引用内容1

    >>引用内容2

    >>>引用内容3

    (4)复选文本框

      用法:在选项前添加‘*[ ]’表示选项框,使用‘*[x]’表示选项选中:

      语法示例:

     请选择选项 :

    * [x] 选项1

    * [ ] 选项2

    * [ ] 选项3

    * [x] 选项4

      注意:[ ]内是有一个空格的,表示未选中,x表示选中

     

    (5)超链接

      用法:用[]把超链接文字包起来,然后在后面使用()把超链接url包起来

      语法示例:

    [百度一下](https://www.baidu.com/)

    (6)插入图片

      用法:![图片alt](图片地址)

      图片alt就是显示在图片下面的文字,相当于对图片内容的解释。支持嵌入网络图片或者直接拖入本地图片,其中本地图片格式支持 jpg、png 和 gif

      语法示例:

     ![image](https://www.yinxiang.com/blog/wp-content/uploads/2018/07/%E5%94%AE%E7%A5%A8%E5%BE%AE%E4%BF%A1%E5%B0%81%E9%9D%A22.png)

    (7)列表

      用法:无序列表用 - + * 任何一种都可以;有序列表数字加点;列表嵌套上一级和下一级之间敲三个空格即可;

      语法示例:

     - 列表1

    + 列表2

    * 列表3

    1.  列表1

    2.  列表2

    3.  列表3

    + 一级目录1

        - 二级目录1

        - 二级目录2

    + 一级目录2

        - 二级目录3

        - 二级目录4

    (8)表格

      用法:

      第二行分割表头和内容。

      ① - 有一个就行,为了对齐,多加了几个文字默认居左

      ② -两边加:表示文字居中

      ③ -右边加:表示文字居右

      注:原生的语法两边都要用 | 包起来。

      格式如右所示:   表头|表头|表头

                ---|:--:|---:

                内容|内容|内容

                内容|内容|内容

      语法示例:

     | 帐户类型 | 免费帐户 | 标准帐户 | 高级帐户 |

    | :---: | :---: | :---: | :---: |

    | 帐户流量 | 60M | 1GB | 10GB |

    | 设备数目 | 2台 | 无限制 | 无限制 |

    | 当前价格 | 免费 | ¥8.17/月 | ¥12.33/月|

     

     

    (9)图表

      用法:目前支持饼状图、折线图、柱状图和条形图,只需将 type 改为对应的pie、line、column 和 bar。

      语法示例:

      ①饼状图

     ```chart

    ,预算,收入,花费,债务

    June,5000,8000,4000,6000

    July,3000,1000,4000,3000

    Aug,5000,7000,6000,3000

    Sep,7000,2000,3000,1000

    Oct,6000,5000,4000,2000

    Nov,4000,3000,5000,

    type: pie

    title: 每月收益

    x.title: Amount

    y.title: Month

    y.suffix: $ 

    ```

      ②折线图

     ```chart

    ,预算,收入,花费,债务 

    June,5000,8000,4000,6000 

    July,3000,1000,4000,3000 

    Aug,5000,7000,6000,3000 

    Sep,7000,2000,3000,1000

    Oct,6000,5000,4000,2000

    Nov,4000,3000,5000,

    type: line

    title: 每月收益

    x.title: Amount 

    y.title: Month

    y.suffix: $

    ```

      ③柱状图

    ```chart

    ,预算,收入,花费,债务

    June,5000,8000,4000,6000 

    July,3000,1000,4000,3000

    Aug,5000,7000,6000,3000

    Sep,7000,2000,3000,1000

    Oct,6000,5000,4000,2000

    Nov,4000,3000,5000,

    type: column

    title: 每月收益

    x.title: Amount

    y.title: Month 

    y.suffix: $ 

    ```

      ④条形图

    ```chart

    ,预算,收入,花费,债务

    June,5000,8000,4000,6000

    July,3000,1000,4000,3000

    Aug,5000,7000,6000,3000

    Sep,7000,2000,3000,1000

    Oct,6000,5000,4000,2000

    Nov,4000,3000,5000,

    type: bar

    title: 每月收益

    x.title: Amount

    y.title: Month

    y.suffix: $

    ```

    (10)代码

      Markdown 语法支持几十种编程语言的高亮的显示。

      用法:代码之间分别用一个或三个反引号包起来,

      语法示例:单行代码:`代码内容`

     `System.out.println("输出内容");`

      多行代码:

      ```

        代码块

      ```

     ```

    public static int add(int a, int b){

        return a+b;

    }

    ```

    (11)流程图

      用法:

      ①关键词:graph TD

      ②标号[模块内容]  矩形框

      ③标号(模块内容)  圆角矩形框

      ④标号{判断条件}  棱形判断框

      ⑤|条件|  判断条件/注释

      语法示例:

     ```mermaid

    graph TD

    A(开始) --> B[输入账号密码]

    B --> C{账号密码是否正确}

    C -->|是| D[登录成功]

    C -->|否| E[登录失败]

    D-->F(结束)

    E-->F

    ```

     

    (12)时序图

      用法:

      ①关键词:sequenceDiagram

      ②->>:   实线流(:后面空一格)

      ③-->>:   虚线流(:后面空一格)

      ④文字说明可以跟在流的后面

      语法示例:

     ```mermaid

    sequenceDiagram

    A->>B: 是否已收到消息?

    B-->>A: 已收到消息

    ```

     

  • 相关阅读:
    generator
    JS 中 apply 、call 、bind的详解
    前端面试题(24-js)
    JS原型链深入了解
    Java12新特性
    Java11-ZGC
    Java11新特性
    Java10新特性
    Java9新特性
    CF1385E【Directing Edges】 (拓扑排序)
  • 原文地址:https://www.cnblogs.com/huangrizhang/p/huangrizhang_markdown.html
Copyright © 2020-2023  润新知