md文件的基本常用编写语法

md简介

.md即markdown文件的基本常用编写语法,是一种快速标记、快速排版语言，现在很多前段项目中的说明文件readme等都是用.md文件编写的，而且很多企业也在在鼓励使用这种编辑方式。下面就简单和大家分享一些.md基本语法。

一、基本符号：* - +. >

1、前面带#号，后面带文字，分别表示h1-h6,只到h6，而且h1下面会有一条横线

1 # 一级标题
2 ## 二级标题
3 ### 三级标题
4 #### 四级标题
5 ##### 五级标题
6 ###### 六级标题

2、标签闭合

1 # 一级标题 #
2 ## 二级标题 ##
3 ### 三级标题 ###
4 #### 四级标题 ####
5 ##### 五级标题 #####
6 ###### 六级标题 #####

效果如下：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体

• 加粗

要加粗的文字左右分别用两个*号包起来

• 斜体

要倾斜的文字左右分别用一个*号包起来

• 斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

• 删除线

要加删除线的文字左右分别用两个~~号包起来

1 **这是加粗的文字**
2 *这是倾斜的文字*`
3 ***这是斜体加粗的文字***
4 ~~这是加删除线的文字~~

效果如下：

这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>
n个...
貌似可以一直加下去，但没神马卵用

示例：

1 >这是引用的内容
2 >>这是引用的内容
3 >>>>>>>>>>这是引用的内容

效果如下：

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。

示例：

1 ---
2 ----
3 ***
4 *****

效果如下：
可以看到，显示效果是一样的。

---

---

---

五、图片

语法：

1 ![图片alt](图片地址 ''图片title'')
2
3 图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
4 图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

示例:

![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/
u=702257389,1274025419&fm=27&gp=0.jpg "区块链")

效果如下：

上传本地图片直接点击导航栏的图片标志，选择图片即可

六、超链接

语法：

1 [超链接名](超链接地址 "超链接title")
2 title可加可不加

示例：

[博客](http://www.cnblogs.com)
[百度](http://www.baidu.com)

博客
百度

注：Markdown本身语法不支持链接在新页面中打开，貌似简书做了处理，是可以的。别的平台可能就不行了，如果想要在新页面中打开的话可以用html语言的a标签代替。

1 <a href="超链接地址" target="_blank">超链接名</a>
2
3 示例
4 <a href="https://www.baidu.com.com" target="_blank">百度</a>

七、列表

无序列表

语法：
无序列表用 - + * 任何一种都可以

1 - 列表内容
2 + 列表内容
3 * 列表内容
4
5 注意：- + * 跟内容之间都要有一个空格

效果如下：

• 列表内容
• 列表内容
• 列表内容

有序列表

语法：
数字加点

1 1. 列表内容
2 2. 列表内容
3 3. 列表内容
4
5 注意：序号跟内容之间要有空格

效果如下：

1. 列表内容
2. 列表内容
3. 列表内容

列表嵌套

上一级和下一级之间敲三个空格即可

• 一级无序列表内容

  • 二级无序列表内容
  • 二级无序列表内容
  • 二级无序列表内容

• 一级无序列表内容

  1. 二级有序列表内容
  2. 二级有序列表内容
  3. 二级有序列表内容

1. 一级有序列表内容

   • 二级无序列表内容
   • 二级无序列表内容
   • 二级无序列表内容

2. 一级有序列表内容

   1. 二级有序列表内容
   2. 二级有序列表内容
   3. 二级有序列表内容

八、表格

语法：

 1 表头|表头|表头
 2 ---|:--:|---:
 3 内容|内容|内容
 4 内容|内容|内容
 5
 6 第二行分割表头和内容。
 7 - 有一个就行，为了对齐，多加了几个
 8 文字默认居左
 9 -两边加：表示文字居中
10 -右边加：表示文字居右
11 注：原生的语法两边都要用 | 包起来。此处省略

示例：

1 姓名|技能|排行
2 --|:--:|--:
3 刘备|哭|大哥
4 关羽|打|二哥
5 张飞|骂|三弟

效果如下：

姓名	技能	排行
刘备	哭	大哥
关羽	打	二哥
张飞	骂	三弟

九、代码

语法：
单行代码：代码之间分别用一个反引号包起来

1     `代码内容`

代码块：代码之间分别用三个反引号包起来，且两边的反引号单独占一行

(```)
  代码...
  代码...
  代码...
(```)

注：为了防止转译，前后三个反引号处加了小括号，实际是没有的。这里只是用来演示，实际中去掉两边小括号即可。

示例：

单行代码

`create database hero;`

代码块

1 (```)
2     function fun(){
3          echo "这是一句非常牛逼的代码";
4     }
5     fun();
6 (```)

效果如下：

单行代码

create database hero;

代码块

1 function fun(){
2   echo "这是一句厉害的代码";
3 }
4 fun();

十、流程图

1 ```flow
2 st=>start: 开始
3 op=>operation: My Operation
4 cond=>condition: Yes or No?
5 e=>end
6 st->op->cond
7 cond(yes)->e
8 cond(no)->op
9 &```

效果如下：

• 加粗

要加粗的文字左右分别用两个*号包起来