Markdown

评论

Markdown是什么？

Markdown 是一种轻量级标记语言，使用的是纯文本的方式。诞生初期是为了简化 HTML 语法，用于编写阅读次数多、更新频率高，但内容格式相对稳定的 README 类的文档。所以 Markdown 语法支持嵌入原始的 HTML 标记语言，支持 CSS 样式。

我们所看到的 Markdown 网页预览的效果，其实都是将 Markdown 文档内容首先转换成 HTML 标签，再配以某些默认预定共同渲染而成的。同样的一段表格代码，在 Typora 和 VS Code 预览中的表现不同，为了让 Markdown 的表现形式稳定，我们可将 Markdown 导出成 HTML 文件。

Markdown 分级标题

1
2
3
4
5
6
# 这是一个标题
## 这是一个标题
### 这是一个标题
#### 这是一个标题
##### 这是一个标题
###### 这是一个标题

?

Markdown 段落

在 Markdown 文件中，没有任何标记的文字会被解析成正文。

1
2
3
### 这是标题

这是一段正文文字。

?

Markdown 列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
** 无序列表**

使用星号生成无序列表

* 项目1
* 项目2
* 项目3

使用加号生成无序列表

+ 项目1
+ 项目2
+ 项目3

使用减号生成无序列表

- 项目1
- 项目2
- 项目3

?

有序列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

1. 项目1
2. 项目2
3. 项目3

源码中的数字与渲染后的数字并不一一对应，但可以决定列表的开始序号

例如，让 Markdown 渲染器自动安排序号：

0. 项目1
0. 项目2
0. 项目3

让有序列表以 “2” 开头：

2. 项目1
1. 项目2
0. 项目3

?

Markdown 引用

在 Markdown 文件中，用「大于号」开头的行会被转换为块引用。
如果需要在块引用内的换行，可以在行尾增加两个连续的空格。

1
2
3
4
> 一支穿云箭，千军万马来相见；  
> 两副忠义胆，刀山火海提命现。  
>
> —— 星仔

Markdown 强调

斜体的演示
1
2
3
4
5
6
7
8
9
10
11

  *用星号表示的斜体*

  _用下划线表示的斜体_


- 粗体的演示

  **用星号表示的粗体**

  __用下划线表示的粗体__

Markdown 辅助线

"空格" 时，删除线效果会失效。
1
2
3
4

~~有效的删除线~~

~~失效的删除线 ~~

?

Markdown 代码块

使用反引号定义代码块

使用反引号定义代码块，并定义高亮(在反引号后加语言名称)

1
2
3
pubic static void main(String[] args) {
    System.out.println("Hello world");
}

Markdown 超链接

一对中括号就可以将文字转换为超链接，如: [北京](www.baidu.com)，[上海]()，[广州]()，[深圳]()

?

Markdown 图片

1
![?](Markdown/8.png)

Markdown 注释

1
2
这是一段没有被注释的文字
<!-- 这是一段被注释掉的文字 -->

?

Markdown 表格

1
2
3
4
5
|学号|姓名|age|
|:---|----|---:|
|1|张三|21|
|2|李四|43|
|3|王五|76|

?

Markdown 生成目录

在 Markdown 中，自动生成目录非常简单，只需要在恰当的位置添加 [TOC] 符号，凡是以 # 定义的标题都会被编排到目录中。