Markdown学习笔记
Markdown学习笔记
Hokori新博客需要用Markdown语言来进行书写,刚好md文件一般都是用来写文档的,见猎心喜之下,顺便学一下Markdown到底应该怎么写,而不是像之前一样,连格式都不知道是怎么样的,就瞎写了。Markdown的教程网上有很多,而我是基于菜鸟教程这个网站来进行学习的,再加上如果有什么特别的东西需要书写,就单独搜索,因此这个页面可能大部分要和菜鸟教程里的一致~~
Markdown标题
===和—符号
1 | 一级标题 |
在文本后面加上===则是一级标题,在文本后面加上—则是二级标题
#符号
1 | # 一级标题 |
#符号是最经常使用的标题符号了吧应该,使用方式是在文本前面加上#符号,也可以表示标题,一级标题对应一个#号,二级对应两个,最多六个,也就是最多六级标题。
注意:#符号后面一定至少有空格
段落样式
Markdown没有特殊样式,因此直接编写文字就可以了,但是我们看的时候总是习惯有段落的样式,因此还是需要设置一些东西的。
首行缩进
首行缩进,在教程中是没有这玩意儿的,如果要缩进的话,可以按Tab键,但是这样会更改段落样式,因此我不太喜欢
1 | |
如果要首行缩进而不改变样式的话,我觉得还是使用 好。
字体
1 | *斜体文本* |
根据教程,和_符号都能设置字体,一个是斜体,两个是粗体,三个是粗斜体
分隔线
如上所示就是分分隔线了
1 | * * * |
如上代码都可以用来做分隔线的代码,只要是三个以上的*或-或_就可以了,理论上来说空格不空格是无所谓的,不过建议每一个符号中间有一个空格,这样就不会产生字体上的歧义了(***符号是斜体)
删除线
删除线
这是一段删除线啊
如果要在文字上加上删除线,只需要在对应的文字两端加上~~即可了。如:
1 | ~~删除线~~ //这样的 |
下划线
下划线
下划线是通过html的u标签来实现的,代码如下:
1 | <u>下划线</u> |
脚注
1 | [^要注明的文本] |
教程里是这样写的,但是好像因为Markdown没有规范,所以每个用的都不太一样,这个没办法作为常规写法,我没有写出效果来,所以没办法显示了。
列表
无序列表
- 第一项
- 第二项
- 第三项
1 | * 第一项 |
这是无序列表
有序列表
- 第一项
- 第二项
3.第三项
1 | 1. 第一项 |
这是有序列表,不过样式感觉不太对的样子
列表嵌套
- 第一项:
- 第一项第一个元素
- 第一项第二个元素
- 第二项
- 第二项第一个元素
第二项第二个元素
- 第二项第一个元素
1 | 1. 第一项: |
这是列表嵌套的写法,只需要在上一层列表后推后四格,就可以了,如果还要下一层列表的话就加上列表符号
区块
区块引用
区块引用
区块内容
1 | > 区块引用 |
这是区块的引用写法,写出来之后便独立成了一个区块,有特殊的用法。
区块嵌套
第一层区块
第二层区块
1 | > 第一层区块 |
这是区块嵌套的写法,但是我不太清楚,或者说感觉不到有什么地方需要用到区块的,因此到时候有用处再说吧。
区块中使用列表
- 第一项
- 第二项
1 | > + 第一项 |
这样就可以在区块中使用列表了,在列表中使用区块也是同理的。
代码
`符号
如果是一个函数或者片段的代码可以使用`符号将其包裹起来,如npm run dev
pirnt(1) print(2) print(3)
1 | ` |
在使用一个`符号的时候,可以看到,会将所有的代码都变成一行,失去了原本的格式。
```符号
为了解决`的缺陷,在显示多行代码的时候可以使用```来包裹代码,这样就不会失去之前的样式了。
1 | pirnt(1) |
Tab键
还有一种方法也可以来区分区块,那就是Tab制表符,在代码前使用Tab或者四个空格,都可以用来显示代码
print(123);
不过就像上面的一样,这个感觉不太稳定,因此不推荐使用。
链接
简易写法
链接1
[链接1](http://www.baidu.com)
链接的建议写法如上所示,有时()可以换成<>。
拆分写法
为了书写简便美观,大家都习惯性将所有的链接放在一块,因此可以使用拆分写法
链接2
1 | [链接2] |
注意:在两者之间一定要有换行,或者说下面的链接赋值一定要换行,距离上面要有一行以上,否则不生效
图片
图片的写法和链接其实是差不多的,但是又有些小小的差别,这两者不能弄混,要不然就不会生效的。
简易写法
![图片1](http://static.runoob.com/images/runoob-logo.png)
图片的写法在前面有个感叹号
拆分写法
1 | ![图片2] |
这里是在引用的地方加感叹号,而不是在赋值的地方加感叹号
表格
Markdown表格
姓名 | 年龄 |
---|---|
张三 | 12 |
李四 | 13 |
1 | |姓名|年龄| |
使用|来进行表格的分隔,使用-来分隔表头和其他行
左对齐
:- 设置内容和标题栏居左对齐。
姓名 | 年龄 |
---|---|
张三 | 12 |
李四 | 13 |
1 | |姓名|年龄| |
右对齐
-: 设置内容和标题栏居右对齐。
姓名 | 年龄 |
---|---|
张三 | 12 |
李四 | 13 |
1 | | 姓名 | 年龄 | |
居中对齐
:-: 设置内容和标题栏居中对齐。
姓名 | 年龄 |
---|---|
张三 | 12 |
李四 | 13 |
1 | | 姓名 | 年龄 | |
表格必须要与其他内容空两行(上面空一行、下面空一行)
高级技巧
支持html元素
不在Markdown涵盖范围之内的标签,都可以在文档里面使用HTML撰写。
目前支持的HTML元素有:
<kbd>
<b>
<i>
<em>
<sup>
<sub>
<br>
等。
转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
1 | **文本加粗** |
公式
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。
这个暂且没有接触到,就不仔细写了。