# Markdown 语法入门：写法与渲染效果对照

> 本文用“写法”和“效果”成对展示常用 Markdown 语法。每一节先把源码放进代码块，再用真正的 Markdown 写一遍，方便对照学习。

Markdown 是一种轻量级标记语言。掌握少量符号，就能写出结构清晰的文档。

## 1. 标题

![1.00](https://developer.qcloudimg.com/http-save/yehe-12518072/57ed2b76e5fff11cd018c4397fc8a439.png)

**写法：**

```markdown
# 一级标题
## 二级标题
### 三级标题
```

**效果：**

### 这是一个三级标题

标题前的 `#` 越多，标题层级越低。通常一篇文章只使用一个一级标题。

## 2. 加粗、斜体与删除线

**写法：**

```markdown
**加粗文本**
*斜体文本*
~~删除线文本~~
```

**效果：**

**加粗文本**

*斜体文本*

~~删除线文本~~

## 3. 无序列表与有序列表

**写法：**

```markdown
- 苹果
- 香蕉
  - 嵌套项

1. 第一步
2. 第二步
```

**效果：**

- 苹果

- 香蕉

  - 嵌套项

1. 第一步
2. 第二步

无序列表也可以使用 `*` 或 `+`；有序列表使用数字加英文句点。

## 4. 链接与行内代码

**写法：**

```markdown
[示例网站](https://example.com)
执行命令：`npm install`
变量名：`userName`
```

**效果：**

[示例网站](https://example.com)

执行命令：`npm install`

变量名：`userName`

链接使用 `[显示文字](有效网址)` 的形式；行内代码使用一对反引号包裹。

## 5. 多行代码块

**写法：**

````markdown
```javascript
function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet("Markdown"));
```
````

**效果：**

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}

console.log(greet("Markdown"));
```

在开头的三枚反引号后标注 `javascript`、`python` 等语言名称，编辑器通常会提供语法高亮。

## 6. 引用与分隔线

**写法：**

```markdown
> 这是一段引用内容。

---
```

**效果：**

> 这是一段引用内容。

---

引用段落以 `>` 开头；三个或更多连字符可创建分隔线。

## 7. 表格

**写法：**

```markdown
| 语法 | 用途 |
| --- | --- |
| `#` | 标题 |
| `**文本**` | 加粗 |
| `` `代码` `` | 行内代码 |
```

**效果：**

| 语法         | 用途   |
| ---------- | ---- |
| `#`        | 标题   |
| `**文本**`   | 加粗   |
| `` `代码` `` | 行内代码 |

表头下方的连字符行决定表格列数；单元格中也可以继续使用行内 Markdown。

## 8. 写作小建议

1. 每个段落只表达一个主要意思。
2. 代码示例尽量短小，并标注代码语言。
3. 发布前预览文章，检查链接地址、列表缩进和表格对齐。

现在你已经能同时看懂 Markdown 的源码与实际渲染效果，可以开始写自己的技术文档了。

Markdown 语法入门：写法与渲染效果对照（测试）

Markdown 语法入门：写法与渲染效果对照 本文用“写法”和“效果”成对展示常用 Markdown 语法。每一节先把源码放进代码块，再用真正的 Markdown 写一遍，方便对照学习。 Markdown 是一种轻量级标记语言。掌握少量符

编程语言

开发工具

测试

学习Markdown语法快速入门，掌握标题、加粗、列表、代码块等常用标记写法与效果对照。通过源码与渲染对比，轻松编写结构清晰的技术文档，提升写作效率。

4核4G3M云服务器 新用户低至38元/年！

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Markdown 语法入门：写法与渲染效果对照（测试）-腾讯云开发者社区-腾讯云

Markdown 语法入门：写法与渲染效果对照（测试）

Markdown 语法入门：写法与渲染效果对照（测试）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐