MarkDown基础语法大全

Posted huangrizhang

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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: 已收到消息

```

技术图片

 

 

以上是关于MarkDown基础语法大全的主要内容,如果未能解决你的问题,请参考以下文章

Markdown 数学公式语法

JIRA常用markdown语法整理

Markdown 简介及基础语法

Markdown基础语法(上)

MarkDown基础语法

MarkDown基础语法