因为现在的前端基本上都用上了前端构建工具,那就难免要写一些readme等等的说明性文件,但是这样的文件一般都是.md的文件,编写的语法自然跟其他格式的文件有所区别,本文也是我学习写markdown文件的一个笔记吧,仅供参考!
正文:
1、标题的几种写法:
第一种:
一级标题
二级标题
三级标题
四级标题
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题
前面带#号,后面带文字,分别表示h1-h6,上图可以看出,只到h6,而且h1下面会有一条横线,注意,#号后面有空格
第二种:
这是一级标题
这是二级标题
这是一级标题 =============== 这是二级标题 -----
这种方式好像只能表示一级和二级标题,而且=和-的数量没有限制,只要大于一个就行
第三种:
一级标题
二级标题
# 一级标题 # ## 二级标题 ##
2、列表
我们都知道,列表分为有序列表和无序列表,下面直接展示2种列表的写法:
无序列表
- 1
- 2
- 1
- 2
- 1
- 2
### 无序列表 * 1 * 2 + 1 + 2 - 1 - 2
可以看到,无序列表可以用 , + , — 来创建,用在线编辑器看,实际上是转换成了ul>li ,所以使用哪个都可以,推荐使用吧
有序列表就相对简单一点,只有这一种方式,注意,数字后面的点只能是英文的点,特别注意,有序列表的序号是根据第一行列表的数字顺序来的,比如说:
有序列表
- 1
- 2
- 3
- 5
- 4
### 有序列表 1. 1 2. 2 3. 3 5. 5 4. 4
第一组本来是12354 倒序,但是现实12345 ,这点必须注意了
3、区块引用
比如说,你想对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语句
- 生存还是毁灭
这是一个问题
* 生存还是毁灭 > 这是一个问题--- 无序列表下方的便是引用,可以有多种用途,看你的需求了,用法就是在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格 引用因为是一个区块,理论上是应该什么内容都可以放. 将上面的代码稍微改一下,全部加上引用标签,就变成了一个大的引用,还有引用里面还有引用,那引用嵌套引用还没有别的写法呢? >1 >>2 >>>3 >>>>4 >>>>>5 >>>>>>6
>1 >>2 >>>3 >>>>4 >>>>>5 >>>>>>6上图可以看出,想要在上一次引用中嵌套一层引用,只需多加一个>,理论上可以无限嵌套,我就不整那么多了,注意:多层嵌套的>是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧 4、华丽的分割线 分割线可以由* - _(星号,减号,底线)这3个符号的至少3个符号表示,注意至少要3个,且不需要连续,有空格也可以
应该看得懂吧,但是为了代码的排版好看,你们自己定规则吧,前面有用到星号,建议用减号
5、链接
支持2种链接方式:行内式和参数式,不管是哪一种,链接文字都是用 [方括号] 来标记。
行内式
彳亍怎么读?
### 行内式 [彳亍](www.baidu.com)怎么读?
参数式
名字name.
### 参数式 [name]: http://www.baidu.com "名称" 名字[name].
链接还可以带title属性,好像也只能带title,带不了其他属性,注意,是链接地址后面空一格,然后用引号引起来
这是行内式的写法,参数式的怎么写:
6、图片
图片也有2种方式:行内式和参数式,
图片
这里是图片
### 图片  [图片]: /asagi//img/signature.png 这里是图片![图片]用法跟链接的基本一样,唯一的不同就是,图片前面要写一个!(这是必须的),没什么好说的 7、代码框 这个就比较重要了,很多时候都需要展示出一些代码 如果代码量比较少,只有单行的话,可以用单反引号包起来,如下:
11111111111111111111111111
8、表格
表格
1 | 2 | 3 |
---|---|---|
2 | 3 | 4 |
1 | 2 | 3 |
--- 1|2|3 -|-|- 2|3|4 1|2|3
9、强调
强调
字体倾斜
字体倾斜
字体加粗
字体加粗
### 强调 *字体倾斜* _字体倾斜_ **字体加粗** __字体加粗__
一个星号或者是一个下划线包起来,会转换为倾斜,如果是2个,会转换为加粗
11、删除线
###删除线
删除
~~删除~~