Markdown基本语法学习
Markdown作为一种非所见即所得的轻量级格式控制语言,能适用于博客、文档等很多场景,它能够让作者更加关注文章内容而不用考虑太多排版的问题。熟悉Markdown后可以写出更美观规范博客,本次就来回顾一下常用的Markdown基本语法。
# 正文
# 1. 使用不同级别的标题
Markdown支持两种格式的标题写法:一种是Setext式(使用得少),在标题下面一行写上任意数量的等号或下划线都表示一级标题;另外一种是常用的atx式,使用N个警号+标题文本就是N级标题(考虑兼容性,警号后最好加上空格),如:
# 一级标题
## 二级标题
2
效果为:
# 一级标题
# 二级标题
# 2. 使用列表项
Markdown中列表项分为有序列表和无序列表,有序列表使用数字+.+空格+列表项,无序列表使用星号+空格+列表项,值得注意的是无序列表通过添加制表符缩进可以实现分级,如:
1. 有序项目1
2. 有序项目2
* 列表项目1
* 子项目
* 孙项目
* 列表项目2
2
3
4
5
6
7
效果为:
- 有序项目1
- 有序项目2
- 列表项目1
- 子项目
- 孙项目
- 子项目
- 列表项目2
# 3. 引用与自定义容器
在行首使用右尖括号来表示引用,如:
> 学术就是包装
效果为:
学术就是包装
VuePress支持Emoji、目录和自定义容器等一些扩展Markdown语法,如:
:tada: :100:
::: tip
This is a tip
:::
::: warning
This is a warning
:::
::: danger
This is a dangerous warning
:::
::: theorem 牛顿第一定律
假若施加于某物体的外力为零,则该物体的运动速度不变。
::: right
来自 [维基百科](https://zh.wikipedia.org/wiki/)
:::
::: details 点击查看代码
你好,VuePress!这是一个详情块,在 IE / Edge 中不生效
:::
<!-- more --> 划分文章的预览区域,注意空格
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
效果为:
🎉 💯
This is a tip
This is a warning
This is a dangerous warning
点击查看代码
console.log('你好,VuePress!这是一个详情块,在 IE / Edge 中不生效')
# 4. 字体控制
使用星号(或下划线)和波浪号包住文字来实现字体控制,一对星号为斜体,两对星号为粗体,三对星号为粗体加斜体,两对波浪号为删除线。直接在单行使用三个星号表示分割线(另外注意Markdown中换行通常需要额外加一个回车),如:
*斜体* _斜体_
**粗体** __粗体__
***粗体加斜体***
~~此处省略一万字~~
***
2
3
4
5
6
效果为: 斜体 斜体 粗体 粗体
粗体加斜体 此处省略一万字
# 5. 代码框(Code Fence)
代码框中的格式控制都会失效,单行代码引用直接首尾用一个重音符包住,多行代码框使用两行三个重音符将代码框在中间,并可以说明语言种类来实现代码高亮,代码框不能嵌套,所以下面示例代码框中的括号实际使用时是没有的。
`__import java.util.*__`
(```java
有关代码
```)
2
3
4
5
效果为:
__import java.util.*__
public class Main{
public static void main(String[] args){
System.out.println("Hello World!");
}
}
2
3
4
5
# 6. 使用表格
通过竖线来分隔表的列,回车来分隔行。表头/属性和表记录间需要作额外分隔,使用一个或多个连字符来分隔。如:
| 姓名 | 年龄 |指标|
| -|:--:| ---:| (默认对齐方式与解析程序有关,也可使用冒号控制)
| 张三李四王五 | 18 | 18,27,30 |
2
3
表中的空格和连字符的数量不影响最终呈现,仅在源码中调节对齐,效果为:
姓名 | 年龄 | 指标 |
---|---|---|
张三李四王五 | 18 | 18,27,30 |
# 7. 图片和网页超链接
使用如下方式创建超链接,图片不需要链接文字并需要在前面加感叹号
[链接文字]+(链接地址+"(可选)链接的鼠标悬停title")
![](链接地址+"(可选)链接的鼠标悬停title")
也可以在文末批量定义图片:
[img01]: https://.../x.jpg "(可选)title"
然后在文中使用![] [img01]的方式来引用
2
3
4
5
6
以上就是常用的Markdown语法了,并不是很复杂,平时多使用就能很快熟练掌握。