Markdown 的基本语法和示例

隔壁小白

已于 2025-06-22 23:06:13 修改

阅读量782

点赞数 11

CC 4.0 BY-SA版权

分类专栏： markdown 文章标签： markdown

于 2025-06-22 22:55:17 首次发布

本文链接：https://blog.csdn.net/cbaln0/article/details/148834265

markdown 专栏收录该内容

1 篇文章

订阅专栏

编写 Markdown 文档非常简单，Markdown 是一种轻量级标记语言，用简单的语法就能实现格式化的文本。以下是 Markdown 的基本语法和示例：

1. 标题

用 # 表示标题，数量越多，级别越低：

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

效果：

一级标题

二级标题

三级标题

四级标题

2. 段落与换行

段落：直接输入文字，段落之间空一行。
换行：在行尾加两个空格，或者直接空一行。

这是第一段。  
这是同一段的换行。

这是第二段。

效果：
这是第一段。
这是同一段的换行。

这是第二段。

3. 文字样式

粗体：**粗体** 或 __粗体__
斜体：*斜体* 或 _斜体_
~~删除线~~：~~删除线~~
行内代码：`行内代码`

示例：

**粗体**，*斜体*，~~删除线~~，`行内代码`

效果：
粗体，斜体，~~删除线~~，行内代码

4. 列表

无序列表（用 `-`、`*` 或 `+`）：

- 项目1
- 项目2
  - 子项目（缩进2空格或1个Tab）

效果：

项目1
项目2
- 子项目

有序列表（数字加点）：

1. 第一项
2. 第二项
   1. 子项（缩进3空格）

效果：

第一项
第二项
1. 子项

5. 链接与图片

链接：[显示文本](URL)
```
[Google](https://www.google.com)
```
效果：Google
图片：![替代文本](图片URL)
```
![Markdown图标](https://markdownlogo.com)
```
效果：显示图片（需替换为有效URL）。

6. 引用

用 > 表示引用：

> 这是引用的内容。  
> 可以多行使用。

效果：

这是引用的内容。
可以多行使用。

7. 代码块

行内代码：`code`

多行代码：用三个反引号 ```（可指定语言）：

```python
def hello():
    print("Hello, Markdown!")
```

效果：

def hello():
    print("Hello, Markdown!")

8. 表格

用 | 和 - 对齐：

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

效果：

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

9. 分隔线

用 ---、*** 或 ___：

---

效果：

10. 转义字符

用 \ 输出特殊符号（如 #、*）：

\*这不是斜体\*

效果：*这不是斜体*

11. 任务列表

用 - [ ] 或 - [x]：

- [x] 完成任务1
- [ ] 待办任务2

效果：

完成任务1
待办任务2

12. 内嵌 HTML

Markdown 支持内嵌 HTML（如 <br> 换行）：

这是第一行<br>这是强制换行。

效果：
这是第一行
这是强制换行。

示例完整文档：

# Markdown 示例

## 段落与样式
这是**粗体**，这是*斜体*，这是`行内代码`。

## 列表
- 无序列表项
   - 子项
1. 有序列表项

## 代码块
```python
print("Hello World")



## 链接
[Google](https://google.com)

## 表格
| Syntax | Description |
|--------|-------------|
| Header | Title       |