Markdown 使用语法

Hi Sunny
create at 2018-12-27

 什么是Markdown?Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本具有一定的格式。Markdown文件的后缀为 .md  在Sunny看来,Markdown就是HTML的简化版、TXT文本的格式版。如果你在编写中存在难点,你可以直接在Markdown中使用HTML标记语言(包括使用行内样式)。


预览主题

 在这里,介绍下VS Code的MarkDown预览如何更换为GitHub主题。

  1. 使用 Ctrl + Shift + P 打开设置面板,或者点 文件>首选项>设置 打开设置面板。
  2. 设置 "markdown.styles"为引用本地CSS(只能绝对路径),或者引用网上的第三方文件。这里引用了Public-Repertory/css下的markdown-github.css文件。
  3. 配置为:
"markdown.styles": [
  "E:\\project\\sunny\\GithubProjects\\sunny\\docs\\.vuepress\\public\\css\\markdown-github.css"
]

 PS:如果不满意加载本地的 Markdown Style,可以使用 VS Code 的插件:Markdown Preview Github Styling


下面介绍Markdown常用语法:


1. 标题

用法介绍:标题可以像HTML一样使用一级至六级标题,使用#即可,一级标题的使用方法为:# 一级标题,几级标题就使用几个#。

展示:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 无序列表

用法介绍:无序列表可以使用* + -这三种格式,这里推荐使用*:* 列表1

展示:

  • 列表1
  • 列表2
  • 列表3

3. 有序列表

用法介绍:有序列表使用数字1. ***即可,如果开始数字是3,那这个列表就从3. ***开始,第二条是4. ***

展示:

  1. 列表1
  2. 列表2
  3. 列表3 不用担心数字出错之类的问题
  4. 列表4 即使你输入错误也会帮你纠正过来

4. 区块引用

用法介绍:区块引用使用>这个符号,空格后放文本即可:> 一级区块

展示:

注意:区块引用的左边,有个竖线!

注意:引用还可以嵌套使用,这是二级的引用,二级以上相信你也懂了

注意:这是三级嵌套,相信你知道怎么用了


5. 分割线

用法介绍:分隔符使用三个及以上的*或者-或者_都可以,例如三个*:***

展示:





6. 链接

 链接分为行内式和参数式这两种方法

6.1 行内式

用法介绍[Sunny的主页](http://395156224.github.io/)

展示:

Sunny的主页

6.2 参数式

用法介绍

[site]:http://395156224.github.io/ "网站"
[网站]:http://395156224.github.io/ "网站"
这里是[site],这里是[网站]

展示:

这里是site,这里是网站


7. 图片

用法介绍

  • 如果是本地图片,则支持绝对路径和相对路径
  • 如果是网络图片,则可以使用http://**来引入
  • 如果是base64,怎么使用参考markdown引用base64

展示:

图片


8. 代码框

代码框分为单行用和多行用这两种方法:

8.1 单行用

用法介绍``

展示:

<p>你好使用者,要看看Sunny的主页吗?<a href="http://395156224.github.io/">点我跳转</a></p>

8.2 多行用

用法介绍```

```
多行代码文本1
多行代码文本2
多行代码文本3
```

展示:

<p>你好~</p>
<p>要看看Sunny的主页吗?</p>
<p><a href="http://395156224.github.io/">点我跳转</a></p>

9. 表格

表格有三种表示方法:

9.1 第一类表格

用法介绍

| name | age | sex | | :-----: | :--- | ---: | | Sunny | 23 | 男 | | 小梁 | 23 | 男 |

展示:

name age sex
Sunny 23
小梁 23

9.2 第二类表格

用法介绍

| name | age | sex | | ----- | ----- | | Sunny | 23 | 男 | | 小梁 | 23 | 男 |

展示:

表头1 表头2
内容1 内容2
内容3 内容4

9.3 第三类表格

用法介绍

学号 | 姓名 | 分数 - | - | - 小明 | 男 | 75 小红 | 女 | 79 小陆 | 男 | 92

展示:

学号 姓名 分数
小明 75
小红 79
小陆 92

10. 强调

10.1 字体倾斜

用法介绍*字体倾斜*或者_字体倾斜_

展示:

字体倾斜 字体倾斜

10.2 字体加粗

用法介绍**字体加粗**或者__字体加粗__ 展示:

字体加粗 字体加粗


11. 转义

用法介绍:通过使用\加上特殊字符,达到转义效果。

展示:

  • \
  • `
  • ~
  • *
  • _
  • -
  • +
  • .
  • !
  • ……

12. 删除线

用法介绍~~请删除我吧~~

展示:

请删除我吧!


13. 功能实现

 实现的功能:- [x]

  • [x] 功能1
  • [x] 功能2

 未实现的功能:- [ ]

  • [ ] 功能3
  • [ ] 功能4

14. 换行

用法介绍末尾加两个空格即可 也可以直接回车新起一行<br>也支持

111111111(两个空格+回车) 222222222(<br>)
333333333(两个回车换行)

444444444

15. 结语

至此,Markdown语法介绍完毕,有兴趣的小伙伴继续去了解更深层次的Markdown语法吧!——2018年8月21日10:54:26