Markdown-学习记录

一、Markdown 是什么

Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。
Markdown 允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown

---

二、Markdown 基本语法

2.1 标题

使用#号可以表示 1-6 级标题，1 级标题字号最大，字号随#个数递减
代码如下：

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

效果如下:

注意：

• 最后一个#字符与标题中间留一个空格
• 标题应该置于行首，如果放入表格中可能无法正确解析

2.2 字体

星号与下划线都可以，一个是斜体，两个是粗体，三个是粗斜体

代码	效果
*斜体*	斜体
_斜体_	斜体
**粗体**	粗体
__粗体__	粗体
***粗体***	粗体
___粗体___	粗体

快捷键：
加粗 Ctrl+B
斜体 Ctrl+I

2.3 换行

• 直接在一句话后敲两个空格
• 两句话之间加一个空行
• ** 如果你在编辑的时候，想让一行文字在显示的时候换行，就在中间加<br/>**

2.4 引用

Markdown 中引用通过符号 > 来实现，> 符号后的空格，可有可无
在引用的区块内，允许换行存在，换行并不会终止引用的区块。如果要结束引用，需要一行空白行，来结束引用的区块。
代码如下：

> 引用

效果如下：

这是一个引用

引用也可以嵌套，嵌套代码如下：

> 第一个引用
> > 第二个引用
> > > 第三个引用

效果如下：

第一个引用

第二个引用

第三个引用

2.5 链接

Markdown 中插入链接的使用方式是：

[链接名称](链接地址)
<链接地址>

代码如下：

[我的 Github 主页](https://github.com/dieatmore)
或者
<https://github.com/dieatmore>

效果如下：
我的 Github 主页
https://github.com/dieatmore

2.6 图片

Markdown 中插入图片的使用方式是：

![图片描述，可写可不写，但是中括号要有](图片地址，本地链接或者URL地址。)

但是复制图片，直接 Ctrl+v 更便捷

效果如下：

2.7 列表

• 无序列表，使用*、+、-，再加一个空格作为列表的标记
• ** 有序列表，使用数字并加上.号，再加一个空格作为列表的标记**

代码如下：

- 无序列表 1

* 无序列表 2

- 无序列表 3

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

效果如下：

• 无序列表 1
• 无序列表 2
• 无序列表 3

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

如果想要控制列表的层级，则需要在列表符号前使用 Tab
代码如下：

- 无序列表 1
- 无序列表 2
  - 无序列表 2.1
  - 无序列表 2.2

1. 有序列表 1
   1.1 有序列表 1.1
2. 有序列表 2
   2.1 有序列表 2.1

效果如下：

• 无序列表 1
• 无序列表 2
  • 无序列表 2.1
  • 无序列表 2.2

1. 有序列表 1
   1.1 有序列表 1.1
2. 有序列表 2
   2.1 有序列表 2.1

2.8 分割线

分割线的使用，可以在一行中用三个-or*来建立一个分割线让文章结构更加的清晰。
代码如下：

分割线：

---

---

效果如下：
分割线：

---

---

注意：写分割线前，要空一行之后写，否则会导致前一行字体放大

2.9 删除线

删除线的的使用，可以在要添加删除线的文字前后添加两个~
代码如下：

~~被删除的文字~~

效果如图：

这是要被删除的文字

2.10 下划线

下划线的使用和 html 中类似，在需要添加下划线的文字首尾添加<u>文本</u>
代码如下：
<u>文字添加下划线</u>
效果如下：

文字添加下划线

2.11 代码块

Markdown 中代码块有两种：

1. 如果在一行内需要引用代码，只需用反引号`
2. 如果是在一个块内需要引用代码，则在需要引用的代码块的前一行和后
   一行使用三个反引号，同时在前一个反引号后写入代码的语言

代码如下：

效果如下：
printf("Hello World");

~~文字~~

2.12 表格

表格使用|来分割不同的单元格，使用-来分隔表头和其他行

:- 将表头及单元格内容左对齐
-: 将表头及单元格内容右对齐
:-: 将表头及单元格内容居中

代码如下：

| 食品   | 价格 | 数量 |
| :----- | ---: | :--: |
| 西红柿 |  \$9 |  5   |
| 韭菜   |  \$6 |  30  |
| 鸡蛋   | \$10 |  18  |

效果如下：

食品	价格	数量
西红柿	$9	5
韭菜	$6	30
鸡蛋	$10	18

2.13 脚注

脚注是对文本的备注，在 Markdown 中的使用方法
代码如下：

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown 是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

效果如下：
使用 Markdown¹可以效率的书写文档, 直接转换成 HTML², 你可以使用 Typora³ 编辑器进行书写。

注意：脚注自动被搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方

2.14 特殊符号

对于 Markdown 中的语法符号，前面家反斜线\即可以显示符号本身。
代码如下：

\\ \*
\_
\+
\.
等等

效果如下：
\ *
_
+
.
等等

2.15 目录

Markdown 可以在文末自动生成目录索引，让读者更直观地查看文章结构。
代码如下：

# 这是一级标题

## 这是二级标题

### 这是三级标题

@[toc]
# 这是一级标题

正文内容

三、高级用法

如果想要了解更多详细的高级用法：Markdown 高级技巧、markdown 高阶使用技巧

3.1 制作待办事项

我们可以使用 Markdown 来制作一个待办事项，格式为、-[] 表示未完成；-[x]表示已完成
代码如下：

- [ ] 支持以 PDF 格式导出文稿
- [ ] 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
- [x] 新增 Todo 列表功能
- [x] 修复 LaTex 公式渲染问题
- [x] 新增 LaTex 公式编号功能

效果如下：

• 支持以 PDF 格式导出文稿
• 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
• 新增 Todo 列表功能
• 修复 LaTex 公式渲染问题
• 新增 LaTex 公式编号功能

3.2 书写公式

Markdown 支持书写公式，$$表示整行公式

代码如下：
$$E=mc^2$$
效果如下：

$$E=m{c}^2$$

3.3 Html

Markdown 支持原生 HTML 语法

四、总结

记录自己的学习过程，温故知新

---

1. Markdown 是一种纯文本标记语言 ↩︎

2. HyperText Markup Language 超文本标记语言 ↩︎

3. NEW WAY TO READ & WRITE MARKDOWN. ↩︎