欢迎光临
我们一直在努力

Markdown 语法简明指南 - 笔记

## 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
![梦翼坊 Logo](https://xiangfa.org/images/logo.svg “这是梦翼坊的 Logo”)
“`
–  **使用引用标签**:
“`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

登录

找回密码

注册