Markdown 语法详解

May 3, 2026 · 7 mins read
Markdown 语法详解

Markdown:简单高效的标记语言

Markdown 是一种轻量级的标记语言,由 John Gruber 和 Aaron Swartz 创建。它的设计目标是“易读易写”,允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML。Markdown 在技术写作、博客、论坛和笔记应用中得到了广泛应用,包括 GitHub、Reddit 和许多 CMS 系统。

1. 标题 (Headings)

Markdown 使用 # 号来创建标题。# 的数量决定了标题的级别,最多支持六级。

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

2. 段落 (Paragraphs)

段落就是普通文本。段落之间需要一个或多个空行来分隔。

3. 换行 (Line Breaks)

在 Markdown 中,简单的回车不会产生换行。要强制换行,你需要在行的末尾添加两个或更多的空格,然后回车。

第一行文本  
第二行文本

4. 强调 (Emphasis)

Markdown 支持两种强调方式:

  • 斜体 (Italic):用一个星号 * 或下划线 _ 包围文本。
    *这是斜体*
    _这也是斜体_
    
  • 粗体 (Bold):用两个星号 ** 或下划线 __ 包围文本。
    **这是粗体**
    __这也是粗体__
    
  • 粗斜体 (Bold Italic):结合使用。
    ***这是粗斜体***
    ___这也是粗斜体___
    

5. 列表 (Lists)

Markdown 支持有序列表和无序列表。

5.1 无序列表 (Unordered Lists)

使用星号 *、加号 + 或减号 - 来创建无序列表。

* 项目一
* 项目二
  * 子项目 A
  * 子项目 B
- 项目三
+ 项目四

5.2 有序列表 (Ordered Lists)

使用数字后跟一个英文句点 . 来创建有序列表。数字的顺序并不重要,Markdown 会自动编号。

1. 第一项
2. 第二项
   1. 子项 1
   2. 子项 2
3. 第三项

6. 引用 (Blockquotes)

使用大于号 > 来创建引用。可以嵌套使用。

> 这是一个引用块。
>
> > 这是一个嵌套的引用块。

7. 代码 (Code)

7.1 行内代码 (Inline Code)

使用反引号 ` 来包裹行内代码。

这是一个包含 `inline code` 的句子。

7.2 代码块 (Code Blocks)

使用三个反引号 `` 来包裹多行代码。你也可以在三个反引号后指定语言,以启用语法高亮。

```python
def greet(name):
    print(f"Hello, {name}!")

greet("World")

### 8. 链接 (Links)

Markdown 的链接格式为 `[链接文本](URL "可选的标题")`。

```markdown
[访问开云集团官网](https://www.kaiyun.com "开云集团官方网站")

9. 图片 (Images)

图片格式与链接类似,但需要在前面加一个感叹号 !。格式为 ![图片替代文本](图片URL "可选的标题")

![Markdown 标志](https://markdown.com/assets/img/markdown-logo.png "Markdown Logo")

10. 分割线 (Horizontal Rules)

可以使用三个或更多星号 *、减号 - 或下划线 _ 来创建水平分割线。

---
***
___

11. 表格 (Tables)

Markdown 支持创建表格,但不是所有 Markdown 解析器都支持。通常使用竖线 | 和减号 - 来构建。

| 列名1 | 列名2 | 列名3 |
| :---- | :---: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 单元格 | 单元格 | 单元格 |
  • : 在分隔符的左边表示左对齐。
  • : 在分隔符的两边表示居中对齐。
  • : 在分隔符的右边表示右对齐。

12. 转义字符 (Escaping Characters)

如果你想显示 Markdown 语法中使用的特殊字符,例如 *#> 等,可以在字符前加上反斜杠 \ 来进行转义。

\* 这不会被渲染成斜体 \*
\# 这不会被渲染成一级标题

结论

Markdown 语法简洁而强大,掌握这些基本元素,你就可以在各种平台高效地创建和编辑文本内容。开云集团在内部文档管理和对外信息发布中,广泛采用 Markdown,以确保内容的一致性和易读性。

Sharing is caring!