## Markdown 语法简明指南 – 笔记
### 一、 Markdown 简介
– **定义**:
– Markdown 是一种轻量级标记语言,用于以纯文本形式编写文档,并最终以 HTML 格式发布。
– 旨在让用户专注于内容创作,而非排版格式。
– **特点**:
– **易读易写**: 使用简单的标记语法,文本内容清晰易读。
– **跨平台**: 广泛用于各种平台,例如 GitHub、简书、掘金等。
– **可扩展**: 支持嵌入 HTML 标签、公式、流程图等高级功能(取决于编辑器)。
– **应用场景**:
– 撰写技术文档、博客文章、论坛帖子等。
– 制作 README 文件、笔记、待办事项等。
### 二、 Markdown 基础语法
#### 1. **标题**
– **语法**:
– 使用 **等号(=)** 和 **减号(-)** 表示一级和二级标题:
“`markdown
这是一级标题
==============
这是二级标题
————–
“`
– 使用 **井号(#)** 表示 1-6 级标题:
“`markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
“`
– **效果**:
– 一级标题和二级标题分别对应 HTML 中的 `<h1>` 和 `<h2>` 标签,以此类推。
#### 2. **段落**
– **语法**:
– 段落之间需有空行。
– **强制换行**:
– 在行尾添加 **两个或多个空格** + 回车。
– 或者在段落之间添加一个空行。
– **示例**:
“`markdown
这是一个段落。
这是另一个段落。
这是一个段落,后面带了两个空格。
这是另一个段落。
“`
#### 3. **字体样式**
– **斜体**:
– 使用一个 **星号(*)** 或 **下划线(_)** 包裹文本:
“`markdown
*斜体文本*
_斜体文本_
“`
– **粗体**:
– 使用两个 **星号(**)** 或 **下划线(__)** 包裹文本:
“`markdown
**粗体文本**
__粗体文本__
“`
– **粗斜体**:
– 使用三个 **星号(***)** 或 **下划线(___)** 包裹文本:
“`markdown
***粗斜体文本***
___粗斜体文本___
“`
– **删除线**:
– 使用两个 **波浪号(~~)** 包裹文本:
“`markdown
~~删除线文本~~
“`
– **混合使用**:
– 可以在同一段文本中混合使用不同的字体样式:
“`markdown
**月光如流水一般**,静静地泻在这一片叶子和花上。
叶子和花*仿佛在牛乳中洗过一样*;
___酣眠固不可少,小睡也别有风味的___ 。
“`
#### 4. **列表**
– **无序列表**:
– 使用 **星号(*)**、**加号(+)** 或 **减号(-)** 作为列表标记:
“`markdown
* 项目一
* 项目二
* 项目三
+ 项目一
+ 项目二
+ 项目三
– 项目一
– 项目二
– 项目三
“`
– **有序列表**:
– 使用数字 + **点(.)** 作为列表标记:
“`markdown
1. 项目一
2. 项目二
3. 项目三
“`
– **嵌套列表**:
– 在子列表前添加 **两个或四个空格** 或 **一个制表符**:
“`markdown
– 一级列表
* 二级列表
* 二级列表
1. 一级列表
1. 二级列表
2. 二级列表
“`
#### 5. **待办事项**
– **语法**:
– 使用 **方括号([])** 表示待办事项,其中 **空格** 表示未完成,**x** 表示已完成:
“`markdown
– [ ] 未完成事项
– [x] 已完成事项
“`
– **嵌套待办事项**:
– 与嵌套列表类似:
“`markdown
– [ ] 日常
1. [x] 吃饭
2. [x] 睡觉
3. [ ] 打豆豆
“`
#### 6. **区块引用**
– **语法**:
– 在段落前添加 **大于号(>)**:
“`markdown
> 这是一个区块引用
“`
– **嵌套引用**:
– 使用多个 **大于号(>)** 实现嵌套:
“`markdown
> 第一层引用
>> 第二层引用
>>> 第三层引用
“`
– **混合使用**:
– 可以在区块引用中混合使用其他 Markdown 语法:
“`markdown
> **加粗文本**
> 1. 有序列表
> 2. 有序列表
“`
#### 7. **分割线**
– **语法**:
– 使用 **三个或更多** 的 **星号(***)**、**减号(—)** 或 **下划线(___)**:
“`markdown
***
—
___
“`
#### 8. **链接**
– **行内式**:
– “`markdown
[链接文本](链接地址 “可选标题”)
“`
– “`markdown
<链接地址>
“`
– **参考式**:
– “`markdown
[链接文本][引用标签]
“`
– 在文档其他位置定义引用标签:
“`markdown
[引用标签]: 链接地址 “可选标题”
“`
– **示例**:
“`markdown
这是一篇关于 [Markdown][1] 的文章。
[1]: https://daringfireball.net/projects/markdown/ “Markdown 官方网站”
“`
#### 9. **图片**
– **语法**:
– “`markdown
“`
– **示例**:
“`markdown

“`
– **使用引用标签**:
“`markdown
![梦翼坊 Logo][logo]
[logo]: https://xiangfa.org/images/logo.svg
“`
#### 10. **表格**
– **语法**:
– 使用 **竖线(|)** 分隔列,使用 **短横线(-)** 分隔表头和内容:
“`markdown
| 左对齐 | 居中对齐 | 右对齐 |
| :—– | :——: | —–: |
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |
“`
– **对齐方式**:
– **左对齐**: 使用 **冒号(:)** 在短横线左侧。
– **居中对齐**: 使用 **冒号(:)** 在短横线两侧。
– **右对齐**: 使用 **冒号(:)** 在短横线右侧。
#### 11. **代码**
– **行内代码**:
– 使用 **反引号(`)** 包裹代码:
“`markdown
使用 `printf()` 函数输出文本。
“`
– **代码区块**:
– 使用 **四个空格** 或 **一个制表符** 缩进代码:
“`markdown
#include <stdio.h>
int main() {
printf(“Hello, World!”);
return 0;
}
“`
– 或者使用 **围栏代码块**(**三个反引号(“`)**):
“`markdown
“`
#include <stdio.h>
int main() {
printf(“Hello, World!”);
return 0;
}
“`
“`
– **指定代码语言**(适用于大多数 Markdown 编辑器):
“`markdown
“`c
#include <stdio.h>
int main() {
printf(“Hello, World!”);
return 0;
}
“`
“`
### 三、 高级技巧
#### 1. **支持混合使用 HT