Markdown语法使用学习和示例

Markdown语法使用学习和示例

手里一直有一台闲置的服务器,想着能用来干点什么。心血来潮,通过Hexo搭建了一个个人博客,但是一直没有深入的使用和了解,
又心血来潮想着通过博客记录点什么,于是着手学习和了解一下markdown的语法,下面是个人学习markdown的一些记录。

背景介绍

Markdown 是一种轻量级标记语言 (Lightweight Markup Language),其主要目标是实现“易读易写”。
它不是一种排版工具,而是一种文本格式化方法。它的核心理念是让人们能够用纯文本进行写作,同时这种文本格式本身就具有高度的可读性,
即使在没有渲染器解析的情况下,也能清晰地理解文档的结构和内容。

from Gemini

语法说明之-标题

markdown中有6种标题,分别为一级标题、二级标题……六级标题,大家根据实际需要选择合适的标题进行使用,以达到预期效果和目的下面是语法及示例:
以一个# 加一个空格开头,字体会被加粗加大
以二个## 加一个空格开头,字体比一级标题略小一点
以三个### 加一个空格开头,字体比二级标题略小一点
以四个#### 加一个空格开头,字体比三级标题略小一点
以五个##### 加一个空格开头,字体比四级标题略小一点
以六个###### 加一个空格开头,字体比五级标题略小一点

一级标题#

二级标题##

三级标题###

四级标题####

五级标题#####
六级标题######
1
2
3
4
5
6
# 一级标题`# `
## 二级标题`## `
### 三级标题`### `
#### 四级标题`#### `
##### 五级标题`##### `
###### 六级标题`###### `

语法说明之-列表

列表分为两种类型(有资料上说是三类,额外包括任务列表,大家根据需要自行了解),有序列表和无序列表,可以通过+-*三种符号开头,可以根据个人习惯选择自己喜欢的方式,
通过Tab控制列表层级

  • 无序列表1
  • 无序列表2
  • 无序列表3
    • 子无序列表1
    • 子无序列表2
      • 孙无序列表1
      • 孙无序列表1
        • 子子孙孙无序列表…
1
2
3
4
5
6
7
8
* 无序列表1
* 无序列表2
* 无序列表3
- 子无序列表1
- 子无序列表2
+ 孙无序列表1
+ 孙无序列表1
- 子子孙孙无序列表...

语法说明之-链接

阅读人可以点击链接跳转到指定网页,链接文字会被置为蓝色:这是一个可以点击的链接语法符号为[]()
链接文本放在方括号 [] 内,链接地址放在圆括号 () 内。

1
[这是一个可以点击的链接](www.baidu.com)

语法说明之-图片

将你需要展示的图片添加到文档中,图片会直接显示,语法符号为![]()
与链接类似,但在开头多一个感叹号 !。方括号内是图片的描述文本(),表述文本会在图片加载失败是显示。
这是图片

1
![这是图片](Markdown使用语法_files/1.jpg)

语法说明之-代码块

使用三个反引号```包裹多行代码。在开始的三个反引号后可以指定编程语言进行语法高亮,并且通过```结束代码块。

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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
System.out.print("hello,world!")
```
![](Markdown使用语法_files/2.jpg)
## 语法说明之-表格
markdown中表格的创建相对复杂,使用 | 符号分隔单元格,使用 --- 分隔表头和表内容,通过在分隔线 (---) 中使用冒号 (:) 来控制对齐方式:。
| 左对齐 | 具中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 这是表体 | 这是表 | 这是表体 |

复杂表格可通过HTML表示:
<table>
<thead>
<tr>
<th rowspan="2">项目编号</th>
<th colspan="2">第一季度数据</th>
<th colspan="2">第二季度数据</th>
</tr>
<tr>
<th>收入</th>
<th>支出</th>
<th>收入</th>
<th>支出</th>
</tr>
</thead>
<tbody>
<tr>
<td>A-001</td>
<td>5000</td>
<td>1200</td>
<td>6500</td>
<td>1500</td>
</tr>
<tr>
<td colspan="5" style="text-align: center;">年度总结:前两季度表现良好。</td>
</tr>
</tbody>
</table>

```markdown
| 左对齐 | 具中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 这是表体 | 这是表 | 这是表体 |

<table>
<thead>
<tr>
<th rowspan="2">项目编号</th>
<th colspan="2">第一季度数据</th>
<th colspan="2">第二季度数据</th>
</tr>
<tr>
<th>收入</th>
<th>支出</th>
<th>收入</th>
<th>支出</th>
</tr>
</thead>
<tbody>
<tr>
<td>A-001</td>
<td>5000</td>
<td>1200</td>
<td>6500</td>
<td>1500</td>
</tr>
<tr>
<td colspan="5" style="text-align: center;">年度总结:前两季度表现良好。</td>
</tr>
</tbody>
</table>

语法说明之-引用

使用大于号>来表示引用的内容。

这是一段引用的文字。
引用可以包含多行,并且可以嵌套其他 Markdown 元素。
倾斜 加粗 过时 倾斜加粗

其它

  1. 行内代码
    • 通过两个反引号包裹起来``,这是行内代码
  2. 倾斜字体
    • 通过一个下划线或者星号包裹起来_*, 我是倾斜字体
  3. 字体加粗
    • 通过两个下划线或者星号包裹起来__**, 我是加粗字体
  4. 倾斜加粗
    • 通过三个下划线或者星号包裹起来___***,我是倾斜加粗
  5. 删除线字体
    • 通过两个波浪线包裹起来~~,我过时了呜
  6. 分割线
    - 通过三个及以上减号表示---

  7. 注释
    • 通过<!-- -->表示,双减号中间的内容不会在页面显示