Markdown 学习笔记

本文由Markdown编写，效果如是：

学习网站： 菜鸟教程

编辑器：Typora

主题：非默认、下载的Purple主题

---

正文

目录

一. Markdown 简介
二. Markdown 标题
三. Markdown 段落格式
四. Markdown 列表
五. Markdown 区块
六. Markdown 代码
七. Markdown 链接
八. Markdown 图片
九. Markdown 表格
十. Markdown 高级技巧

小注：

• 可以通过按Shift+Enter键在编辑视图中显式插入单个换行符。
• 纯文本粘贴：Ctrl+Shift+v
• 加粗标题：先标题，后加粗

---

一、Markdown 简介

​

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

1. Markdown 应用

• Markdown 能被使用来撰写电子书，如：Gitbook。
• 当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如：GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

2. 编辑器：Typora

3. 编辑器主题：Purple（不同主题，格式呈现效果不同，但是语法都一样）

---

**二、Markdown 标题 **

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

写法如下：

# 一号小黄
## 二号小黄
### 三号小黄

Purple主题效果如下：（主题不同，不同级别标题表现形式不同，如：默认的Whitey主题标题均居中）

一号小黄

二号小黄

三号小黄

---

三. Markdown 段落格式

1. 段落换行：

两个空格+回车键 注： 可以通过按Shift+Enter键在编辑视图中显式插入单个换行符。

2. 字体：

• 斜体： *包裹
• 加粗： **包裹
• 粗斜体：***包裹

3. 分隔线：空行输入***

---

---

4. 删除线：用~~包裹起来

5. 下划线 ：可以通过 HTML 的<u> 标签来实现</u>，包裹起来

6. 脚注：（感觉用不到，用的时候再说吧）

---

四. Markdown 列表

1. 分类：有序列表、无序列表

• 无序列表：*+空格 (注：再内层需要——4个空格+*+空格、后边会单独提到嵌套)

写法如下：

* 第一项* 第一层* 第二层* 第三层
* 第二项
* 第三项 

效果如下：

• 第一项
  • 第一层
    • 第二层
      • 第三层
• 第二项
• 第三项

• 有序列表：数字+.+空格

写法如下：

 1. 第一2. 第二3. 第三 

效果如下：

1. 第一
2. 第二
3. 第三

2. 列表嵌套：4个空格+*+空格

写法如下：

1. 第一层：* 第一层嵌套一* 第一层嵌套二

效果如下：

1. 第一：
   • 第一层嵌套一
   • 第一层嵌套二

---

五. Markdown 区块

1. 段落开头使用 >+空格

写法如下：

> 小黄
> 小红
> 小蓝

效果如下：

小黄
小红
小蓝

2. 区块可嵌套 注：每层都要是>+空格

写法如下：

> 内二层
> > 内一层
> >
> > > 最内层

效果如下：

内二层

内一层

最内层

3. 可以在：区块中使用列表、列表中使用区块

---

六. Markdown 代码

1. 段落内插入片段的代码：

写法如下：

`include <reg51.h>` 这是头文件

效果如下：
include <reg51.h>这是头文件

2. 代码块

* 代码区块使用 4 个空格或者一个制表符（Tab 键）  * 也可以用 ```包裹一段代码，并指定一种语言（也可以不指定）：

void uart_send1 (UART_MemMapPtr uartch, uint8 ch)
{//等待发送缓冲区空while(!(UART_S1_REG(uartch) & UART_S1_TDRE_MASK));//发送数据UART_D_REG(uartch) = (uint8)ch;}

---

七. Markdown 链接

1. [链接名称](链接地址)

写法如下：

[百度网](www.baidu.com)

效果如下：
百度网

2. <链接地址>

写法如下：

<www.baidu.com>

效果如下：
<www.baidu.com>

3. 高级链接（用的时候再学吧）

---

八. Markdown 图片

语法：

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

注：

开头一个感叹号 !
接着一个方括号，里面放上图片的替代文字
接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 ‘title’ 属性的文字。

写法如下：

![百度](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)

效果如下：

---

九. Markdown 表格

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

写法如下：

|  姓名   | 分数  |
|  ----  | ----  |
| 小黄  | 10分 |
| 小蓝  | 10分 |

效果如下：

姓名	分数
小黄	10分
小蓝	10分

2. 对齐方式：

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

写法如下：

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 

效果如下：

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

十. Markdown 高级技巧(略)

• 支持的 HTML 元素
• 转义
• 公式
• 流程图、时序图、顺序图、甘特图…

式：

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。

写法如下：

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 | 

效果如下：

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

十. Markdown 高级技巧(略)

• 支持的 HTML 元素
• 转义
• 公式
• 流程图、时序图、顺序图、甘特图…