Markdown学习笔记

    新博客需要用Markdown语言来进行书写,刚好md文件一般都是用来写文档的,见猎心喜之下,顺便学一下Markdown到底应该怎么写,而不是像之前一样,连格式都不知道是怎么样的,就瞎写了。Markdown的教程网上有很多,而我是基于菜鸟教程这个网站来进行学习的,再加上如果有什么特别的东西需要书写,就单独搜索,因此这个页面可能大部分要和菜鸟教程里的一致~~

Markdown标题

===和—符号

1
2
3
4
 一级标题
===
二级标题
---

在文本后面加上===则是一级标题,在文本后面加上—则是二级标题

#符号

1
2
3
# 一级标题
## 二级标题
### 三级标题

    #符号是最经常使用的标题符号了吧应该,使用方式是在文本前面加上#符号,也可以表示标题,一级标题对应一个#号,二级对应两个,最多六个,也就是最多六级标题。
注意:#符号后面一定至少有空格

段落样式

    Markdown没有特殊样式,因此直接编写文字就可以了,但是我们看的时候总是习惯有段落的样式,因此还是需要设置一些东西的。

首行缩进

    首行缩进,在教程中是没有这玩意儿的,如果要缩进的话,可以按Tab键,但是这样会更改段落样式,因此我不太喜欢

1
    

如果要首行缩进而不改变样式的话,我觉得还是使用&nbsp好。

字体

1
2
3
4
5
6
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

    根据教程,和_符号都能设置字体,一个是斜体,两个是粗体,三个是粗斜体

分隔线


如上所示就是分分隔线了

1
2
3
* * *
- - -
_ _ _

如上代码都可以用来做分隔线的代码,只要是三个以上的*或-或_就可以了,理论上来说空格不空格是无所谓的,不过建议每一个符号中间有一个空格,这样就不会产生字体上的歧义了(***符号是斜体)

删除线

删除线
这是一段删除线
如果要在文字上加上删除线,只需要在对应的文字两端加上~~即可了。如:

1
2
~~删除线~~ //这样的
这是一段~~删除线~~啊 //段中也可以加

下划线

下划线
下划线是通过html的u标签来实现的,代码如下:

1
<u>下划线</u>

脚注

1
2
[^要注明的文本]
[^要注明的文本]: 这是一个脚注

教程里是这样写的,但是好像因为Markdown没有规范,所以每个用的都不太一样,这个没办法作为常规写法,我没有写出效果来,所以没办法显示了。

列表

无序列表

  • 第一项
  • 第二项
  • 第三项
1
2
3
* 第一项
+ 第二项
- 第三项

这是无序列表

有序列表

  1. 第一项
  2. 第二项
    3.第三项
1
2
3
1. 第一项
2. 第二项
3.第三项

这是有序列表,不过样式感觉不太对的样子

列表嵌套

  1. 第一项:
    • 第一项第一个元素
    • 第一项第二个元素
  • 第二项
    • 第二项第一个元素
      第二项第二个元素
1
2
3
4
5
6
1. 第一项:
+ 第一项第一个元素
+ 第一项第二个元素
+ 第二项
- 第二项第一个元素
- 第二项第二个元素

这是列表嵌套的写法,只需要在上一层列表后推后四格,就可以了,如果还要下一层列表的话就加上列表符号

区块

区块引用

区块引用
区块内容

1
2
> 区块引用
区块内容

这是区块的引用写法,写出来之后便独立成了一个区块,有特殊的用法。

区块嵌套

第一层区块

第二层区块

1
2
> 第一层区块
>> 第二层区块

这是区块嵌套的写法,但是我不太清楚,或者说感觉不到有什么地方需要用到区块的,因此到时候有用处再说吧。

区块中使用列表

  • 第一项
  • 第二项
1
2
> + 第一项
> + 第二项

这样就可以在区块中使用列表了,在列表中使用区块也是同理的。

代码

`符号

如果是一个函数或者片段的代码可以使用`符号将其包裹起来,如npm run dev
pirnt(1) print(2) print(3)

1
2
3
4
5
`
pirnt(1)
print(2)
print(3)
`

在使用一个`符号的时候,可以看到,会将所有的代码都变成一行,失去了原本的格式。

```符号

为了解决`的缺陷,在显示多行代码的时候可以使用```来包裹代码,这样就不会失去之前的样式了。

1
2
3
pirnt(1)
print(2)
print(3)

Tab键

还有一种方法也可以来区分区块,那就是Tab制表符,在代码前使用Tab或者四个空格,都可以用来显示代码
print(123);
不过就像上面的一样,这个感觉不太稳定,因此不推荐使用。

链接

简易写法

链接1
[链接1](http://www.baidu.com)
链接的建议写法如上所示,有时()可以换成<>。

拆分写法

为了书写简便美观,大家都习惯性将所有的链接放在一块,因此可以使用拆分写法
链接2

1
2
3
[链接2]

[链接2]: http://www.baidu.com

注意:在两者之间一定要有换行,或者说下面的链接赋值一定要换行,距离上面要有一行以上,否则不生效

图片

图片的写法和链接其实是差不多的,但是又有些小小的差别,这两者不能弄混,要不然就不会生效的。

简易写法

图片1
![图片1](http://static.runoob.com/images/runoob-logo.png)
图片的写法在前面有个感叹号

拆分写法

图片2

1
2
3
![图片2]

[图片2]: http://static.runoob.com/images/runoob-logo.png

这里是在引用的地方加感叹号,而不是在赋值的地方加感叹号

表格

Markdown表格

姓名 年龄
张三 12
李四 13
1
2
3
4
|姓名|年龄|
|---|---|
|张三|12|
|李四|13|

使用|来进行表格的分隔,使用-来分隔表头和其他行

左对齐

:- 设置内容和标题栏居左对齐。

姓名 年龄
张三 12
李四 13
1
2
3
4
|姓名|年龄|
| :--- | :--- |
| 张三 | 12 |
| 李四 | 13 |

右对齐

-: 设置内容和标题栏居右对齐。

姓名 年龄
张三 12
李四 13
1
2
3
4
| 姓名 | 年龄 |
| --: | --: |
| 张三 | 12 |
| 李四 | 13 |

居中对齐

:-: 设置内容和标题栏居中对齐。

姓名 年龄
张三 12
李四 13
1
2
3
4
| 姓名 | 年龄 |
| :--: | :--: |
| 张三 | 12 |
| 李四 | 13 |

表格必须要与其他内容空两行(上面空一行、下面空一行)

高级技巧

支持html元素

不在Markdown涵盖范围之内的标签,都可以在文档里面使用HTML撰写。
目前支持的HTML元素有:

  • <kbd>
  • <b>
  • <i>
  • <em>
  • <sup>
  • <sub>
  • <br>

等。

转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:

1
2
**文本加粗** 
\*\* 正常显示星号 \*\*

公式

当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。
这个暂且没有接触到,就不仔细写了。