一.介绍

1.Markdown是一种轻量级标记语言。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

2.由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息

3.vscode可以直接写markdown文件 也可以下载插件

4.markdown文件以.md结尾

5.markdown中可以使用html代码(标签) 利用行内样式设置颜色等

6.预览：

（1）在vscode中右键 选择命令面板
image.png
（2）选择打开侧边预览：
image.png

二.格式

1.标题：

（1）主标题：===
（2）副标题：—-
（3）多级标题：共有六级 后必须加个空格在加内容（一级一个，二级两个*，以此类推）—相当于html的h1到h6

  • 一级标题

  • 二级标题

  • 三级标题

  • 四级标题

  • 五级标题
  • 六级标题

（4）代码展示：

  1. 主标题
  2. ===
  4. 副标题
  5. ---
  7. # 一级标题
  8. ## 二级标题
  9. ### 三级标题
  10. #### 四级标题
  11. ##### 五级标题
  12. ###### 六级标题

效果：
image.png

2.列表：

（1）有序列表：需要使用数字进行编号(数字+.+空格)

    1. 第一个
    1. 第二个
  • 以此类推

（2）无序列表：使用+或-或*然后加空格(每组列表的符号要一致)

    • 第一个
    • 第二个

（3）列表可以嵌套，有序无序都可以随意嵌套
（4）代码展示：

  1. # 有序列表
  2. 1. 第一个
  3. 2. 第二个
  4. # 无序列表
  5. - 第一个
  6. - 第二个

效果：
image.png

3.表格：

（1）要有表头和格式设定，必不可少
（2）竖线间隔每个表头和表格
（3）表头下加|—-|—-|—-|—-|：表示四列

  • 想要几列就用几个—-，每组—-表示一列

（4）默认左对齐

  • 设置居中对齐，就在对应的那组—-左右两侧加冒号
  • |—-|—-|：—-：| 就表示第三列居中对齐 前两列左对齐
  • 右对齐就是在对应—-的右侧加冒号

（5）代码展示：

  1. # 表格
  2. |name|age|sex|address|
  3. |---|:---:|---|---:|
  4. |Jams|35|nan|usa|
  5. |kobe|40|nan|usa|

效果：
image.png

4.分割线：

（1）六种格式：

  • —-(三个连续的减号)
  • _(三个连续的下划线)

（2）建议每种分割线都与内容空出一行，间隔一行
（3）上述分割线的符号最少三个 可以多写 数量不限制
（4）代码展示：

  1. 分割线1
  3. ---
  4. 分割线2
  6. - - -
  7. 分割线3
  9. ***
  10. 分割线4
  12. * * *
  13. 分割线5
  15. ---
  16. 分割线6
  18. - - -

效果：
image.png

5.字体

（1）三种样式：

  • 斜体：内容或内容(左右各一个下划线或*)
  • 粗体：内容或内容(左右各两个个下划线或*)
  • 斜粗体：内容或内容(左右各三个下划线或*)
  • 删除线：~内容~

（2）代码展示

  1. *内容*
  2. _内容_
  3. **内容**
  4. __内容__
  5. ***内容***
  6. ___内容___
  7. ~内容~

效果：
image.png

6.超链接

（1）内容超链接：显示的内容

  • 可以设置想要显示的文字，点击跳转网址

（2）直超链接：格式：<网址>

  • 只会显示一个超链接，点击跳转

（3）代码展示：

  1. #内容超链接
  3. ---
  4. [hello](www.baidu,com)
  5. #直超链接
  7. ---
  8. <https://www.baidi.com>

效果：
image.png

7.图片

（1）格式：图片说明

  • 图片显示不出来才会显示图片说明
  • “内容”是鼠标移入图片显示的内容 可有可无
  • 网络图片写网址，本地图片写地址
  • 括号内地址与图片内容要有空格

（2）代码展示：

  1. #网络图片
  3. ---
  4. ![图片不显示输出该内容](https://tse3-mm.cn.bing.net/th/id/OIP-C.Jl0TYNYSrdumnL_DbbeP9wHaEo?w=301&h=187&c=7&r=0&o=5&pid=1.7 "hello")
  6. ---
  8. #本地图片
  10. ---
  11. ![图片不显示输出该内容](./OIP-C.jpg "hello")

效果：
image.png

8.代码块

（1）单行代码块：两侧各用一个着重号(`)

  • print("hello");

（2）多行代码块：两侧各用三个着重号(`)

  • 可以指定语言的种类，在着重号后

（3）代码展示：

  1. #单行
  3. ---
  4. `print("hello");`
  6. ---
  7. #多行
  9. ---
  10. ```c++
  11. print("hello");
  12. print("hello");
  13. print("hello");
  14. print("hello");
  1. 效果：<br />![image.png](https://cdn.nlark.com/yuque/0/2022/png/27997679/1653187214743-3ecf6efa-1d43-4d66-86e7-3486387c4b20.png#clientId=u2899aa25-c048-4&crop=0&crop=0&crop=1&crop=1&from=paste&height=305&id=uf2553f17&margin=%5Bobject%20Object%5D&name=image.png&originHeight=336&originWidth=759&originalType=binary&ratio=1&rotation=0&showTitle=false&size=10810&status=done&style=none&taskId=u6e75bca2-52bd-4992-8601-f2997db29fa&title=&width=689.999985044653)
  2. <a name="DGp4P"></a>
  3. #### 9.内容引用：指引用其他人的话或文字，需要标注
  4. （1）用>号，要空格后使用><br />（2）空一行表示引用结束<br />（3）引用可以嵌套，符号的数量表示层级<br />（4）代码展示：
  5. ```javascript
  6. #引用
  8. 毛泽东：
  9. >沁园春
  10. 北国风光
  12. 千里冰封
  14. 1说
  15. >2经常说
  16. >>abc
  17. >>>sss

效果：
image.png

10.锚点：定位文章的作用

（1）首先要有锚点 标题就是锚点
（2）跳转锚点：显示的内容

  • 括号内必须有一个#

  • 后加标题名 不管是几级标题 都必须只有一个

  • 点击就会跳转到指定锚点