markdown - doranbai/Note GitHub Wiki

好多时候,我们看了几篇语法介绍就上路了,但是基础概念不清晰使我们深陷泥潭

markdown文档

markdown文档是由什么组成呢?
首先忘掉我们经常使用的word文档的概念
我们思考下文档结构,从抽象意义上,文档的结构是什么?
再次提醒,不要使用word文档的一些概念术语

一本书中我们有连续的章节,所有的章节顺序排列组成了一本书
一篇文档中我们有连续的区块,所有的区块纵向排列组成了一篇文档
这里所说的章节,区块都是抽象概念,里面没有任何内容。一篇文档可以想象成一个大的空白方框,里面的区块可以想象成为一个个空白方框,这只是一个格式,而没有内容。一个大方框,添加了各种标识后被断开成一个个的小方框

实际的文档中有什么区块,markdown是如何规定的?

由大段文字组成的段落,章节标题,表格,大段的引用其他文字,大段的引用代码,分割线等 我们将一个大方框切成了一个个空白方框(注意还是没有内容),就产生了各种区块。所以语法就会有规定,如何切割

段落区块

这个很简单,只要顶部空出一行,这个换行可以是软换行或者是硬换行。
软换行就是Md源码中直接敲回车换行,但是最后显示时不换行。硬换行是先敲两个空格之后再回车,最后显示时会有换行。
那么此空白方框就成为一个段落区块。所以段落区块是没有嵌套的概念,因为只要顶部空出一行这个区块就成为了文档中的段落区块。这个区块一直到下一个区块的开始才会结束。在非段落区块结束后,后面的默认为段落区块,此时可以省略顶部空行。

标题区块

我们值需要在区块开始增加#空格就可以了,注意#号之后有一个空格,区块的结束标志为回车符,这个区间就是标题区块

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

文字引用区块

在区块的开头加上>,结束标志为回车符。区块可以产生层次。n层引用区块需要添加n个>符号,记得添加回车

>内容 回车
>>内容 回车

引用代码

对于在单行区块,在开头加上一个反引号,结束标志为一个反引号(ESC下面那个) 对于多行区块,在区块的开头加上三个反引号,结束标志为三个反引号

分割线

一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。可以在星号或是减号中间插入空格。

***
* * *
*****
- - -
----------

列表区块

区块开头加上*,+等,注意符号后面有空格,结束标志为回车符

表格区块

填充内容

我们建立的区块,最终是要填充内容。这些内容有文本、链接、图片。

markdown中的文字

键盘侠冲冲冲

markdown中的一行文字

前面提到了软换行和硬换行。从开头到硬换行为一行文字。视觉上看着时多行,但在markdown里,这只是一行

文字格式

注意都没有空格

~~删除线~~ 
*斜体字*      _斜体字_
**粗体**  __粗体__
***粗斜体*** ___粗斜体___
上标:X<sub>2</sub>,下标:X<sup>2</sup>

链接

[Github链接](https://github.com/)

图片

开头一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址。

![图片描述](https://图片网址)
⚠️ **GitHub.com Fallback** ⚠️