• 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: 已收到消息

    ```

     

  • 相关阅读:
    eclipse中的Invalid text string (xxx).
    在jsp文件中出现Unknown tag (c:out)
    eclipse 界面复原
    ecilpse 纠错插件
    Multiple annotations found at this line:- The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path
    Port 8080 required by Tomcat v9.0 Server at localhost is already in use. The server may already be running in another process, or a system process may be using the port.
    调用第三方https接口
    调用第三方http接口
    创建带值枚举
    spring整合redis之Redis配置文件
  • 原文地址:https://www.cnblogs.com/huangrizhang/p/huangrizhang_markdown.html
Copyright © 2020-2023  润新知