Sorenavo / 学习手册在编辑器中练习
在线编辑器Markdown 基础

01 / 基础语法

Markdown 基础

这是一篇面向本站编辑器的入门教程。每一节只介绍当前网站可以直接预览的基础语法;阅读语法与实际效果后,可把示例复制到在线编辑器中练习并实时预览。

标题

在文字前添加 # 和一个空格即可创建标题。# 越多,标题层级越低。

markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一篇文档通常只使用一个一级标题,其余内容从二级标题开始组织。

段落与换行

连续文字会组成一个段落,空一行会开始新段落。

markdown
这是第一个段落。

这是第二个段落。

如果只想在同一段中换行,请在行尾输入两个空格后再回车。

强调文字

markdown
*斜体文字*
**粗体文字**
***粗斜体文字***
~~删除的文字~~

实际效果:斜体文字粗体文字粗斜体文字删除的文字

列表

无序列表

markdown
- 苹果
- 香蕉
  - 小香蕉
  - 大香蕉

有序列表

markdown
1. 准备内容
2. 编写文档
3. 检查预览

列表项需要嵌套时,在下一层项目之前添加两个或四个空格。

任务列表

markdown
- [x] 已完成的任务
- [ ] 待完成的任务

实际效果:

引用

在段落前添加 > 可以创建引用。

markdown
> 写作是整理思路的一种方式。

实际效果:

写作是整理思路的一种方式。

链接与图片

链接由方括号中的文字和圆括号中的地址组成;图片只需在相同写法前添加 !。建议使用本站路径或自己可控的资源地址。

markdown
[阅读项目说明](./README.md)
![图片说明](./images/example.png)

图片无法加载时仍会保留“图片说明”,因此替代文字应准确描述图片内容。

分隔线

单独一行输入三个或更多连字符,可以分隔上下文。

markdown
上半部分

---

下半部分

行内代码

用一对反引号包住命令、文件名或变量。

markdown
运行 `npm run build` 可以构建项目。

实际效果:运行 npm run build 可以构建项目。

代码块

用三对反引号包住多行代码。开头反引号后可以填写语言名称,以启用语法高亮。

markdown
```javascript
function add(left, right) {
  return left + right
}
```

实际效果:

javascript
function add(left, right) {
  return left + right
}

表格

使用竖线分隔列,第二行用连字符标记表头。冒号可以控制对齐方向。

markdown
| 项目 | 状态 | 数量 |
| :--- | :---: | ---: |
| 文档 | 完成 | 3 |
| 示例 | 进行中 | 1 |

实际效果:

项目 状态 数量
文档 完成 3
示例 进行中 1