MarkDown入门学习总结教程

标签：教程 MarkDown 入门 代码 标题 语法 Markdown 内容 链接

We believe that writing is about content,about what you want to say – not about fancy formatting.
译文:我们坚信写作写的是内容,所思所想,而不是花样格式.

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")

注释:刚把百度里面的图片复制修改下,在部分内容编辑器可能提示为:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(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**
>
> 懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
>

效果:

Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).

程序员有三种美德:懒惰,急躁和傲慢. —— Larry Wall

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

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

---

代码块

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

---

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

在代码块里面, & 、 < 和 > 会自动转成 HTML 特殊字符,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码
就是说在Markdown代码块里面,不用打特殊字符,比方>,原本是>现在直接输入>就可以了.

高亮显示代码段

除了缩进显示代码段之外,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, but that’s ok. It will eventually wrap the text when the cell is too 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 中将单元格分隔成多行，它们必须保持为单行，如果需要，还可以使用 HTML <br>标记对内容进行强制换行
第二行单元长短与标题不需要保持一致，但必须用竖线（|）分隔
可以有空白的单元格

如何设置单元格内文本对齐方式?可以通过添加冒号:的形式{指定每一列的文本对齐方式需要在在第二行添加}

学习Markdown 这里的编辑预览没法展示,换个内容编辑器查看操作下

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

标签：教程,MarkDown,入门,代码,标题,语法,Markdown,内容,链接
From： https://www.cnblogs.com/webaction/p/16964833.html