Markdown 学习
一 Markdown介绍
1.1 什么是Markdown?
Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。
Markdown 文件的后缀为 .md。
1.2 Markdown是谁创造的?
它是由 Aaron Swartz 和 [John Gruber](https://baike.baidu.com/item/John Gruber/18550453?fr=aladdin) 共同设计, Aaron Swartz 就是那位(2013年1月11日)自杀,有着开挂一般人生经历的程序员。 维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。
1.3 为什么要使用Markdown?
- 它是易读(看起来舒服😌)、易写(语法简单)、易更改(纯文本)。处处体现着极简主义的影子。
- 兼容HTML,可以转换为HTML格式发布。
- 跨平台使用。
- 越来越多的网站支持Markdown.
- 更方便清晰的组织你的电子邮件。(Markdown-here,Airmail)。
- 摆脱Word,txt!!!
二 Markdown 语法
2.1 标题
用法介绍:标题可以像 HTML 一样使用一级至六级标题,使用 # 即可,一级标题的使用方法为:# 一级标题,几级标题就使用几个 #。
-
写法
#### 四级标题 ##### 五级标题 ###### 六级标题
演示:
四级标题
五级标题
六级标题
2.2 无序列表
用法介绍:无序列表可以使用 * + - 这三种格式,这里推荐使用*:* 列表1
-
写法
* 列表1 + 列表2 - 列表3
-
演示:
- 列表1
- 列表2
- 列表3
2.3 有序列表
用法介绍:有序列表使用数字1. ***即可,如果开始数字是3,那这个列表就从3. ***开始,第二条是4. ***
-
写法
1. 列表1 2. 列表2 3. 列表3
-
演示:
- 列表1
- 列表2
- 列表3
2.4 区块引用
用法介绍:区块引用使用 > 这个符号,空格后放文本即可:> 一级区块
-
写法
> 注意:区块引用的左边,有个竖线! >> 注意:引用还可以嵌套使用,这是二级的引用,二级以上相信你也懂了 >>> 注意:这是三级嵌套,相信你知道怎么用了
-
演示:
注意:区块引用的左边,有个竖线!
注意:引用还可以嵌套使用,这是二级的引用,二级以上相信你也懂了
注意:这是三级嵌套,相信你知道怎么用了
2.5 分割线
用法介绍:分割线使用三个及以上的 * 或者 - 或者 _ 都可,这里使用三个 *:***
-
写法
*** --- ___
-
演示:
2.6 链接
- 介绍:链接分为行内式和参数式这两种方法
2.6.1 行内式
-
写法
[webmryang 的网站](https://webmryang.github.io/)
演示:
2.6.2 参数式
-
写法
[site]:https://webmryang.github.io "网站" [网站]:https://webmryang.github.io "网站" 这里是 [site],这里是 [网站]
演示:
2.7 图片
-
用法介绍:
如果是本地图片,则支持绝对路径和相对路径
如果是网络图片,则可以使用 http://** 来引入
如果是 base64,怎么使用参考 markdown 引用 base64 -
写法
![图片](https://qq.yh31.com/tp/zjbq/201901182223553205.gif)
-
演示:
2.8 代码框
- 介绍:代码框分为单行用和多行用这两种方法:
2.8.1 单行用
-
写法
`<p>你好使用者,要看看</p>`
演示:
<p>你好使用者,要看看</p>
2.8.2 多行用
-
写法
```
<p>你好使用者,要看看</p>
<p>你好使用者,要看看</p>
``` 演示:
<p>你好使用者,要看看</p>
<p>你好使用者,要看看</p>
2.9 表格
- 介绍:表格有三种表示方法:
2.9.1 第一类表格
-
写法
| name | age | sex | | :---: | :--- | ---: | | webmryang | 23 | 男 | | 小杨 | 23 | 男 |
演示:
name | age | sex |
---|---|---|
webmryang | 23 | 男 |
小杨 | 23 | 男 |
2.9.2 第二类表格
-
写法
| name | age | sex | | --- | --- | --- | | webmryang | 23 | 男 | | 小杨 | 23 | 男 |
演示:
name | age | sex |
---|---|---|
webmryang | 23 | 男 |
小杨 | 23 | 男 |
2.9.3 第三类表格
-
写法
学号 | 姓名 | 分数 - | - | - 小明 | 男 | 75 小红 | 女 | 79 小陆 | 男 | 92
演示:
学号 | 姓名 | 分数 |
---|---|---|
小明 | 男 | 75 |
小红 | 女 | 79 |
小陆 | 男 | 92 |
2.10 强调
2.10.1 字体倾斜
-
写法
*字体倾斜* _字体倾斜_
演示:
字体倾斜
字体倾斜
2.10.2 字体加粗
-
写法
**字体加粗** __字体加粗__
演示:
字体加粗
字体加粗
2.11 转义
-
用法介绍:通过使用\加上特殊字符,达到转义效果。
-
写法
* \\ * \` * \~ * \* * \_ * \- * \+ * \. * \! * ……
演示:
\
`
~
*
_
-
+
.
!
……
-
2.12 删除线
-
用法介绍:
请删除我吧。-
写法
~~请删除我吧!~~
演示:
请删除我吧! -
2.13 缩略标签
-
用法介绍缩略标签属于 HTML 中的内容,但是巧妙用在 Markdown 也是可行的。
-
写法
<details> <summary>基础知识</summary> 被缩略 你还需要知道其他的吗? </details>
演示:
<details>
<summary>基础知识</summary>被缩略
你还需要知道其他的吗?
</details>
-
三 结语
至此,Markdown 语法介绍完毕,有兴趣的小伙伴继续去了解更深层次的 Markdown 语法吧!