markdown - doranbai/Note GitHub Wiki
好多时候,我们看了几篇语法介绍就上路了,但是基础概念不清晰使我们深陷泥潭
markdown文档是由什么组成呢?
首先忘掉我们经常使用的word文档的概念
我们思考下文档结构,从抽象意义上,文档的结构是什么?
再次提醒,不要使用word文档的一些概念术语
一本书中我们有连续的章节,所有的章节顺序排列组成了一本书
一篇文档中我们有连续的区块,所有的区块纵向排列组成了一篇文档
这里所说的章节,区块都是抽象概念,里面没有任何内容。一篇文档可以想象成一个大的空白方框,里面的区块可以想象成为一个个空白方框,这只是一个格式,而没有内容。一个大方框,添加了各种标识后被断开成一个个的小方框
由大段文字组成的段落,章节标题,表格,大段的引用其他文字,大段的引用代码,分割线等 我们将一个大方框切成了一个个空白方框(注意还是没有内容),就产生了各种区块。所以语法就会有规定,如何切割
这个很简单,只要顶部空出一行,这个换行可以是软换行或者是硬换行。
软换行就是Md源码中直接敲回车换行,但是最后显示时不换行。硬换行是先敲两个空格之后再回车,最后显示时会有换行。
那么此空白方框就成为一个段落区块。所以段落区块是没有嵌套的概念,因为只要顶部空出一行这个区块就成为了文档中的段落区块。这个区块一直到下一个区块的开始才会结束。在非段落区块结束后,后面的默认为段落区块,此时可以省略顶部空行。
我们值需要在区块开始增加#空格就可以了,注意#号之后有一个空格,区块的结束标志为回车符,这个区间就是标题区块
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
在区块的开头加上>,结束标志为回车符。区块可以产生层次。n层引用区块需要添加n个>符号,记得添加回车
>内容 回车
>>内容 回车
对于在单行区块,在开头加上一个反引号,结束标志为一个反引号(ESC下面那个) 对于多行区块,在区块的开头加上三个反引号,结束标志为三个反引号
一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。可以在星号或是减号中间插入空格。
***
* * *
*****
- - -
----------
区块开头加上*,+等,注意符号后面有空格,结束标志为回车符
我们建立的区块,最终是要填充内容。这些内容有文本、链接、图片。
键盘侠冲冲冲
前面提到了软换行和硬换行。从开头到硬换行为一行文字。视觉上看着时多行,但在markdown里,这只是一行
注意都没有空格
~~删除线~~
*斜体字* _斜体字_
**粗体** __粗体__
***粗斜体*** ___粗斜体___
上标:X<sub>2</sub>,下标:X<sup>2</sup>
[Github链接](https://github.com/)
开头一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址。
