Markdown基本语法记录笔记

本文最后更新于:2022年4月13日 下午


​ 通过使用Github Pages + jekyll 的方法也算是搭建了自己的第一篇博客,由于之后post主要都以markdown的文章发布,所以第一篇blog就留给markdown的语法了。

​ 本篇文章参考自Markdown基本语法 - 简书 (jianshu.com),在学习之后做一个汇总,以便自己后续查看和回忆。


一、标题

1
2
3
4
5
6
## 这是一级标题,也就是字最大的
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

其中,不同的效果如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
---

## 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

---

## 二、字体

字体总共有四种排布:

- **加粗**

`**这里是要加粗的字体**`

- *斜体*

``*这里是要倾斜的字体*``

- ***斜体加粗*** ~~(就是粗体+斜体啦)~~

``***这里是要斜体并且加粗的字体***``

- ~~删除线~~

``~~这里是要打删除线的字体~~``

## 三、引用

通过使用引用,可以较为美观的引用别人的内容。

使用示例:

```markdown
> 引用
>> 引用的引用
>>> 引用的引用的引用

引用

引用的引用

引用的引用的引用

四、分割线

分割线有两种实现方式,只要三个,或者三个以上的 ‘-’ 或者 ‘*’ 就可以达到目的,以下为示例

1
2
3
4
---
----
***
****

效果如下




五、图片

Markdown中的图片分为三个部分,分别是“图片介绍”,“图床地址”和“图片信息title”

  • 图片介绍是在图片如果加载失败的时候,将会显示的文字内容
  • 图床地址用于填写图片存放的位置
  • 图片信息显示的title,为鼠标移动到图片上面的时候显示的小字内容(可有可无)
1
![图片介绍](图片url "图片信息显示")

以下为一个示例

1
![背景](https://lsky.halc.top/LY53bA.jpg)

示例: 背景


六、超链接

超链接的语法和图片的语法很像,唯一的区别就是前面是否有那个感叹号,示例如下:

1
2
[超链接的内容](超链接地址 "超链接的title")
[百度](http://baidu.com)

百度

HalcyonAzure的Blog

其中Markdown本身的语法目前并不支持超链接打开,需要使用html语言进行修改,由于目前暂时并未学习html有关内容,所以这部分内容直接引用简书中的内容,暂时不研究。

注:Markdown本身语法不支持链接在新页面中打开,貌似简书做了处理,是可以的。别的平台可能就不行了,如果想要在新页面中打开的话可以用html语言的a标签代替。

1
2
3
4
<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

七、代码

直接贴语法:

1
2
3
4
5
`单行代码内容`

​```
多行代码内容
​```

示例的话上面的很多内容都采用了代码块的方法,所以就不多做展示了

代码折叠

记录一个实现代码折叠的小技巧

1
2
3
4
<details>
<summary>bottom</summary>
`code here`
</details>

效果

bottom`code here`

八、列表

无序列表

语法:无序列表使用’-/+/*'的任意一种符号都可以达到效果

1
2
3
- 内容
+ 内容
* 内容

显示效果:

  • 内容
  • 内容
  • 内容

如果需要列表嵌套,只需要在回车后重复输入列表(快捷键Tab)即可,示例如下:

1
2
3
- 内容
- 内容1
- 内容2
  • 内容
    • 内容1
    • 内容2

Ps: 在使用Typora编辑列表的时候,如果下一行不再需要列表,只需要通过方向键直接移动光标到下一行即可,如果使用回车来换行的话只会进行列表嵌套的操作

有序列表

通过从无序列表进行引申,可以得到有序列表的语法内容:

1
2
1. 内容1
2. 内容2

示例:

  1. 内容1
  2. 内容2

表格和流程图

由于这两部分内容目前还没有遇到使用需求,所以这里同样引用简书内的介绍,等真正有需要和使用的时候再返回这条Blog进行更新和整理

表格

语法:

1
2
3
4
5
6
7
8
9
10
11
>表头|表头|表头
>---|:--:|---:
>内容|内容|内容
>内容|内容|内容

>第二行分割表头和内容。
>- 有一个就行,为了对齐,多加了几个
>文字默认居左
>-两边加:表示文字居中
>-右边加:表示文字居右
>注:原生的语法两边都要用 | 包起来。此处省略

示例:

1
2
3
4
5
>姓名|技能|排行
>--|:--:|--:
>刘备||大哥
>关羽||二哥
>张飞||三弟

效果如下:

姓名技能排行
刘备大哥
关羽二哥
张飞三弟

流程图

出于Blog的排版问题,只有一个示例

st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
&```
~~~


第一篇Blog就是把别人的东西抄了一遍.jpg


Markdown基本语法记录笔记
https://halc.top/p/20c326f2
作者
HalcyonAzure
发布于
2021年3月13日
许可协议