Back to blog
Dec 28, 2024
2 min read

Markdown 简明教程

本文是对markdown 语法进行简明介绍

Markdown 简明教程

Markdown 是一种轻量级标记语言,可以使用简单的文本格式来创建结构化的文档,最终会被转换为 HTML。它易于阅读和编写,广泛用于博客、文档、笔记等场景。

1. 标题

使用 # 符号来定义标题,# 的数量决定标题的级别:

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

2. 段落

段落之间使用空行分隔。

这是第一个段落。

这是第二个段落。

3. 换行

在行尾添加两个或多个空格,然后回车,即可实现换行。

这是第一行  
这是第二行

4. 强调

使用 *_ 包裹文字进行强调:

*斜体*  _斜体_
**粗体**  __粗体__
***粗斜体***  ___粗斜体___

5. 列表

  • 无序列表: 使用 *, +- 开头。
* 项目1
* 项目2
* 项目3

+ 项目A
+ 项目B
+ 项目C

- 项目x
- 项目y
- 项目z
  • 有序列表: 使用数字加点 . 开头。
1. 第一项
2. 第二项
3. 第三项

6. 链接

使用 [链接文字](链接地址) 的格式创建链接:

[百度](https://www.baidu.com)

7. 图片

使用 ![图片描述](图片链接) 的格式插入图片:

![风景图](https://example.com/image.jpg)

8. 引用

使用 > 开头创建引用块:

> 这是一段引用文字。
> 它可以有多行。

9. 代码

  • 行内代码: 使用反引号 ` 包裹。
这是`行内代码`
  • 代码块: 使用三个反引号 ``` 包裹。可以指定代码语言:

    ```python
    def hello():
        print("Hello, Markdown!")
    console.log("Hello, Markdown!");
    这是一个markdown代码块

10. 分割线

使用三个或更多个 *, -_ 创建分割线:

***
---
___

11. 表格

使用 | 分隔列,使用 - 创建表头分隔线:

| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 数据1 | 数据2 | 数据3 |
| 数据a | 数据b | 数据c |

12. 转义字符

使用反斜杠 \ 转义特殊字符,例如:

\*
\_
\#
\`

13. 特殊字符

&等特殊字符需要进行转义,例如&表示&

简要总结:

  • #:定义标题
  • 空行:分隔段落
  • *_:强调
  • *+-:无序列表
  • 数字.:有序列表
  • [链接文字](链接地址):链接
  • ![图片描述](图片链接):图片
  • >:引用
  • `:行内代码
  • ***, ---, ___: 分割线
  • |-:表格
  • \:转义特殊字符

练习:

尝试使用上述语法编写一段自我介绍或博客文章吧!

Markdown 的语法非常简单,熟练使用这些基本语法后,你就可以轻松创建出美观的文档了。希望这份简明教程对你有所帮助!