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

Posted mrwhite2020

tags:

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

效果如下:

技术图片

 

 

 

  • 加粗

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

以上是关于md文件的基本常用编写语法的主要内容,如果未能解决你的问题,请参考以下文章

.md即markdown文件的基本常用编写语法(图文并茂)

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

md文件右边展示效果不见了

markdown Snippets.md是我最常用的HTML,CSS和JavaScript代码片段,用于前端Web开发

markdown(.md)常用语法

MD基本语法介绍