MarkDown 入门学习总结教程

Posted 2022-12-13

Markdown的创始人是John Gruber,Markdown作为一种轻量级的「标记语言」,它使我们专心于码字,用「标记」语法,来代替常见的排版格式.

---

➢段落 一段内容当做一个段落来显示,则需要保证该段内容上方及下方至少各有一个空行(空行含义:某一行只包含空白便会被视为空行)

---

如何对段落进行换行? 不得不说段落这里是比较绕的哈，了解就行 1.使用两个以上空格键加上回车敲个回车键选择题提示:MarkDown中使用回车就可以进行段落的换行为错误说法 2.在段落后面使用一个空行来表示重新开始一个段落敲2个回车,第二个回车写内容代表另起一段 3.在第一行的末尾添加br标签进行换行,就会显示成两段内容添加br敲回车另起一段

---

强调说明: Markdown使用星号*和下划线_作为标记强调字词的符号.

---

斜体 在Markdown中,将内容用*或_包裹起来,包围的字词会被转成用标签包围,会显示成斜体 如果要在文字前后直接插入普通的星号可以用反斜杠\\ * 如果要在文字前后直接插入普通的_插入下划线\\ _ 注意符号连接在一起

---

粗体 用两个*或_包起来就会转换成粗体

---

删除线 使用两个 ~ 来给内容加上删除线,举例:这个内容是被删掉的

---

下划线 输入3个星号*或者hr标签

---

➢标题Markdown支持两种标题的语法Setext和atx形式

---

Setext形式是用底线的形式,利用= (一级标题)和- (二级标题),效果等同h1-h2 举例:注意事项Setext形式的标题至少需要3个以上的=或_才可以正常显示为标题样式

标题1
=====
标题2
-------

Atx形式标题,则是在行首插入1到6个#(最多支持6级标题)对应到h1-h6 举例:

# 标题1
## 标题2

---

➢链接 Markdown支持两种形式的链接语法:行内和参考形式链接.不管是哪一种,链接的文字都是用[方括号]来标记. 行内形式的链接 在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的alt提示文字,只要在网址后面,用双引号把alt文字包起来即可, 其格式为**内容** 例如个人博客

---

参考形式链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签 可以使用[内容]:http_url@提示的形式添加一个超链接

学过Markdown参考形式图片更正下

可以使用参考样式的方式添加一个链接,其结构为 [内容][1] + [1]: http_url "alt 提示" 的组合

---

举例:

[鬼牛阿飞][wiki]

[wiki]: http://www.dhnblog.cn/ "鬼牛阿飞个人博客"

举例:

[鬼牛阿飞][]

[鬼牛阿飞]: http://www.dhnblog.cn/

---

➢图片

行内形式图片的语法格式为

![Alt text](/path/to/img.jpg "Optional title")

注释:刚把百度里面的图片复制修改下,在csdn内容编辑器提示为:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-S0buDZ6F-1670403330252)(/path/to/img.jpg "Optional title")]

参考形式图片的语法格式

![Alt text][id]

[id]: url/to/image  "Optional title attribute"

举例:

---

➢列表:Markdown支持有序列表、无序列表和任务列表 三种形式的列表 无序列表使用 * 、 + 或是 - 作为列表标记符号空格/文字

有序列表则使用小写数字接着一个英文句号数字.空格/文字

当在行首出现数字-句点-空白的内容时，Markdown 会将其当做一个列表进行展示，要避免这样的状况,可以在句点前面加上转义符 \\
1987. What a great season.
列表也可以进行嵌套或者与其他 Markdown 内容

任务列表的语法格式为 - [ ] text，其中 [ ] (带空格的中括号)表示未完成的任务，x 表示已经完成的任务 举例:

- [x] 起床
- [x] 吃饭
- [ ] 工作
- [ ] 睡觉

---

➢分隔线 可以在一行中用三个或以上的*、-、_来创建一个分隔线,行内不能有其他东西.你也可以在星号*中间插入空白

---

引用

Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用:

1.允许只在整个段落的第一行最前面加上 > 2.区块引用可以有级别（例如:引用内的引用）,只要根据级别加上不同数量的 >

> Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).
>
> > 程序员有三种美德:懒惰,急躁和傲慢. —— **Larry Wall**
>
> 懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
>

3.引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码块等支持嵌套

---

代码块

行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可

---

缩进显示代码一个代码块会一直持续到没有缩排的那一行(或是文档结尾) 缩排 4 个空白空格或是 1 个 tab 就可以

高亮显示代码段 除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号（ ```）的行围起来,并在第一个围栏的末尾标识上语言类型即可

	```javascript
	// A highlighted block
	var foo = bar;
	```

```javascript
// A highlighted block
var foo = bar;
```

当然也可以不指定语言类型如果```的这个并排显示,效果等于行内代码块``,不过测试题目中提示该语法不正确

	```
	echo "Hello"
	```

```
echo "Hello"
```

Diff 语法需要注意的是,如果差异内容中包 ,请确保使用反斜杠\\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.

	```diff
	var foo = bar;
	+ var x = 200;
	* var x = 100;
	```

```diff
var foo = bar;
+ var x = 200;
* var x = 100;
```

---

更正下如何转义?示例:

\\`

否则展示就是这样式的:Diff 语法需要注意的是,如果差异内容中包 ,请确保使用反斜杠\\ 来转义每个反引号 ,否则差异突出显示将无法正确呈现.

原本内容其实是:Diff 语法需要注意的是,如果差异内容中包 `,请确保使用反斜杠\\ 来转义每个反引号` ,否则差异突出显示将无法正确呈现.

---

➢表格

单元格展示为

|  |  |
|--|--|
|  |  |

举例为

header1	header2	header3
cell 4	cell 5 is longer	sadasdas
dsasad	asdsada	cell 6 is much longer than the others, <br>but that’s ok. It will eventually wrap<br> the text when the cell is too<br> large for the display size.
cell7		cell9

代码为

| header1 | header2 |header3|
|---|---|---|
|cell 4 | cell 5 is longer |  sadasdas |
|dsasad  | asdsada | cell 6 is much longer than the others, <br>but that’s ok. It will eventually wrap<br> the text when the cell is too<br> large for the display size. |
|cell7||cell9|

语法要求

1. 第一行包含表头，并用"竖线"（ | ）分隔
2. 第二行将标题与单元格分开，并且必须包含三个或更多破折号
3. 第三行以及随后的任何行均包含单元格值

注意事项

如何设置单元格内文本对齐方式?可以通过添加冒号:的形式指定每一列的文本对齐方式需要在在第二行添加 学习Markdown 这里的编辑预览没法展示,建议在CSDN内容编辑器查看操作下

• :--: 两端都有冒号表示内容和标题栏居中对齐
• :--- 左侧冒号表示内容和标题栏居左对齐
• ---: 右侧冒号表示内容和标题栏居右对齐