Markdown学习笔记(2) 基本语法-优快云博客

1. 标题

语法:

# 标题名称

说明： # 的数量表示标题级别，最多支持6级别

示例：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
####### 多于六级无效

效果:

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

####### 多余六级

2. 段落

语法:

p1

p2

说明: 使用空行进行段落隔离

示例:

我是第一段

我是第二段

效果:
我是第一段

我是第二段

注意事项: 不要使用空格或制表符缩进段落。避免兼容问题

3. 换行

语法:

line  
line2

说明: 在一行的末尾添加两个或多个空格，然后按回车键

示例:

我是第一行  
我是第二行

效果:
我是第一行
我是第二行

注意事项: 不推荐不推荐使用反斜杠(\)换行、enter换行

4. 强调

4.1 粗体

语法：

**文本**
__文本__

示例:

**星号加粗**
__下划线加粗__

效果:
星号加粗
下划线加粗

注意事项：推荐星号，不推荐下划线，兼容性考虑，下划线容易和单词和短语之间的下划线混淆

4.2 斜体

语法：

*文本*
_文本_

示例:

*星号斜体*
_下划线斜体_

效果:
星号斜体
下划线斜体

注意事项：推荐星号，不推荐下划线，兼容性考虑，下划线容易和单词和短语之间的下划线混淆

4.3 斜体+粗体

语法：

***文本****
____文本___

示例:

***星号粗体斜体***
___下划线粗体斜体___

效果:
星号粗体斜体
下划线粗体斜体

注意事项：推荐星号，不推荐下划线，兼容性考虑，下划线容易和单词和短语之间的下划线混淆

5. 引用

5.1 段落引用

语法：

> 第一段

示例:

> 这里引用一段话。 --鲁迅

效果:

这里引用一段话。 --鲁迅

5.2 多段引用

语法：

> 第一段
> 
> 第二段

示例:

> 段落一结束
>
> 段落二

效果:

段落一结束

段落二

5.3 嵌套引用

语法:

> 段落一
>
> > 嵌套段落

说明: 嵌套段落前添加一个>>符号

示例:

> 我是主段落
>
> > 我是嵌套段落

效果

我是主段落

我是嵌套段落

注意事项: 带其它元素的块引用。官方说并非所有元素都也可以，可以自行实验

6.列表

6.1 有序列表

语法:

1. item1
2. item2
3. item3

说明: 数字不必按数字顺序排列，但应该以数字1开始。试了下，后续就算不按顺序排，编译后会自动按有序排

示例:

1. 有序列表1
2. 有序列表2
3. 有序列表3

效果:

有序列表1
有序列表2
有序列表3

注意事项: 不推荐使用 1) 、2)

6.2 无序列表

语法：

- item
* item
+ item

说明: 每个列表项前加破折号 (-)或星号 (*) 或加号 (+)

示例:

- 使用破折号
* 使用星号
+ 使用加号

效果:

使用破折号

使用星号

使用加号

注意事项: 推荐使用破折号

6.3 嵌套

语法:

1. item1
2. item2
	other元素

说明：将所要嵌套元素缩进四个空格或者一个制表符。

示例：
嵌套段落

1. 第一项
2. 第二项第一段
	第二项第二段
3. 第三段

效果：

第一项
第二项第一段
第二项第二段
第三段

嵌套引用块

1. 第一项
2. 第二项第一段
	>第二项第二段
3. 第三段

效果:

第一项
第二项第一段

第二项第二段
第三段

列表嵌套

1. 有序1
2. 有序2
	* 无序2.1
    * 无序2.2
3. 有序3

效果:

有序1
有序2
- 无序2.1
- 无序2.2
有序3

7.代码

7.1 单句

语法:

`code`

示例:

`System.out.println("hellow")`

效果:
System.out.println("hellow")

7.2 代码

语法:

	code text

说明:代码每一行缩进至少四个空格或一个制表符

示例:

    这里是一段代码
    System.out.println("hello world.")

效果:
这里是一段代码
System.out.println(“hello world.”)

注意事项: 如果不想使用这种缩进方式，可以参考扩展语法的围栏式代码块。

8.分隔线

语法:

***
---
__

说明:单独一行上使用三个或多个星号破折号下划线

示例:

这里是第一段
***
这里是第二段
___
这里是第三段

效果:
这里是第一段

这里是第二段

这里是第三段

9.链接

9.1 超链接

语法：

[超链接显示名](超链接地址 "超链接title")

说明: title是可选的,是鼠标悬停时会出现的文字

示例:

链接到[百度](https://www.baidu.com "百度一键前往")

效果:
链接到百度

9.2 超链接强调

语法：

**[超链接显示名](超链接地址 "超链接title")**

说明: 超链接前后加上强调符号

示例:

链接到 **[百度](https://www.baidu.com "百度一键前往")**

效果:
链接到百度

10. 图片

语法：

![名称](图片路径 "图片title")

说明:图片路径可以是网络路径、绝对路径或相对路径

示例

这是一个图片 ![示例图片](https://i-blog.csdnimg.cn/direct/ee95080a1d4b4186b7f6f59bdac529c8.jpeg#pic_center "原神启动")

效果：
这是一个图片
示例图片

11. 转义

语法:

\需转义符号

示例:

\\
\*
\[\]

效果:
\
*
[]

注意事项: 代码块中，通常会自动转义；markdown变体语法中，很多字符支持自动转义，需关注工具支持情况

12.内嵌html

markdown支持内嵌Html，但是出于安全考虑，不是所有的markdown软件都支持Html.需要阅读说明。建议非必要不嵌套。

参考信息:

示例图片: Genshin Liyue 发布者：山本KUN一郎