前言

markdown文件的基本常用编写语法,是一种快速标记、快速排版语言,现在很多前段项目中的说明文件readme等都是用.md文件编写的,而且很多企业也在在鼓励使用这种编辑方式,特别作为一个前端从业者更要学会使用这种语言。

而你所看到的这个博客上的文章都是由markdown写出来的,大部分的博客也是需要使用markdown进行编辑,下面呢就来教一些基本的以及一些稍微进阶的

软件

虽然markdown并不需要什么特殊的软件使用txt也可以进行书写但是为了提高效率,以及省去记忆语法的时间,在这里我还是推荐两款软件。

  1. Typora一个很轻量的markdown文本编辑器,使用起来跟word差不多。
  2. 有道云笔记,其中的markdown编辑也是挺好用的,还可以实时预览效果。
  3. 使用一些插件将word转为md文档,尽管字体什么的不能转换但是还是可以的。

基本语法

在这里我会给效果但是还是建议你自己打开编辑器试一试

基本符号:* - +. >

基本上大部分的md文档标记都是基于这四个符号组合,当然是大部分也有例外的情况。

注意:如果使用基本符号开头需要在本符号后有一个用来分割标记与内容的空格,就比如下面这样:

# 不要忘记空格

标题

1.标题的前面带着#号,后面带着文字,#的个数代表几级标题,从h1~h6,最小的标题是h6,并且h1的下面会有一条横线

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2.标签闭合,就好像告诉它这是标题后面的都不是,当然了上面的也可以,只不过需要换行进行编辑

# 一级标题 #
## 二级标题 ##
### 三级标题 ###
#### 四级标题 ####
##### 五级标题 #####
###### 六级标题 #####

效果不如自己打开编辑器试一试

列表

1.无序列表

//形式一
+ a
+ b
+ c
//形式二
- d
- e
- f
//形式三
* g
* h
* i

当然了上面的效果都是一样的,如下面:

  • a
  • b
  • c

2.有序列表

//正常形式
1. abc
2. bcd
3. cde
//错序效果
2. fgh
3. ghi
5. hij

效果:

  1. abc
  2. bcd
  3. cde

注意,数字后面的点只能是英文的点,有序列表的序号是根据第一行列表的数字顺序来的,
错序列表的序号本来是序号是乱的, 但是还是显示 2 3 4

3.嵌套型列表

//无序列表嵌套
+ 123
    + abc
    + bcd
    + cde
+ 465
+ 789
//有序列表嵌套
1. abcd
    1. abcde
    2. abcde
    3. abcde
2. bcde
3. cdef

效果:

  • 123
    • abc
    • bcd
    • cde
  • 465
  • 789
  1. abcd
    1. abcde
    2. abcde
    3. abcde
  2. bcde
  3. cdef

    列表可以嵌套,使用时在嵌套列表前按 tab 或 空格 来缩进,去控制列表的层数

    引用

    对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语法。

1.正常形式

> 引用内容、说明内容。在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格,引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等。

效果:

引用内容、说明内容。在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格,引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等。

2.嵌套
这个有好多方法在这里我只介绍一种,就是给区块的下一级区块多加一个右尖括号

> 一级引用
>> 二级引用
>>> 三级引用
>>>> 四级引用
>>>>> 五级引用
>>>>>> 六级引用

效果:

一级引用

二级引用

三级引用

四级引用

五级引用

六级引用

代码块

有的时候就像这些md语法一样会涉及一些展示代码的问题,这个时候就要用上代码块了

1.少量代码,单行使用,直接用`包裹起来就行了

` shaoliangdaima,danhangshiyong `

效果:
shaoliangdaima,danhangshiyong
2.大量代码,需要多行使用,用```包裹起来

daliangdaima,xuyaoduohangshiyong
   daliangdaima,xuyaoduohangshiyong
   daliangdaima,xuyaoduohangshiyong
   daliangdaima,xuyaoduohangshiyong
   daliangdaima,xuyaoduohangshiyong
效果:
​```markdown
    daliangdaima,xuyaoduohangshiyong
    daliangdaima,xuyaoduohangshiyong
    daliangdaima,xuyaoduohangshiyong
    daliangdaima,xuyaoduohangshiyong
    daliangdaima,xuyaoduohangshiyong

链接

1.行内式

链接的文字放在[]中,链接地址放在随后的()中,链接也可以带title属性,链接地址后面空一格,然后用引号引起来

[小指针的博客](https://blog.ailliom.xyz "生活二次元我全都要"),
是小指针的博客

2.参数式
链接的文字放在[]中,链接地址放在随后的:后,链接地址后面空一格,然后用引号引起来

[小指针的博客]: https://blog.ailliom.xyz "生活二次元我全都要"
[小指针的博客]是小指针的博客。
//参数定义的其他写法
[小指针的博客]: https://blog.ailliom.xyz '生活二次元我全都要'
[小指针的博客]: https://blog.ailliom.xyz (生活二次元我全都要)
[小指针的博客]: <https://blog.ailliom.xyz> "生活二次元我全都要"

上述的两种效果都是一样的,效果如下:

小指针的博客,
是小指针的博客

图片

1.行内式

和链接的形式差不多,图片的名字放在[]中,图片地址放在随后的()中,title属性(图片地址后面空一格,然后用引号引起来),注意的是[]前要加上!

![my-logo.png](https://upload-images.jianshu.io/upload_images/13623636-6d878e3d3ef63825.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "my-logo")

2.图片的文字放在[]中,图片地址放在随后的:后,title属性(图片地址后面空一格,然后用引号引起来),注意引用图片的时候在[]前要加上!

效果待续