XiaoHe'Blog

美好折腾日记

发表于 分类于

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

发表于

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new "My New Post"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

0%