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)
图片格式与链接类似,但需要在前面加一个感叹号 !。格式为 。

10. 分割线 (Horizontal Rules)
可以使用三个或更多星号 *、减号 - 或下划线 _ 来创建水平分割线。
---
***
___
11. 表格 (Tables)
Markdown 支持创建表格,但不是所有 Markdown 解析器都支持。通常使用竖线 | 和减号 - 来构建。
| 列名1 | 列名2 | 列名3 |
| :---- | :---: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 单元格 | 单元格 | 单元格 |
:在分隔符的左边表示左对齐。:在分隔符的两边表示居中对齐。:在分隔符的右边表示右对齐。
12. 转义字符 (Escaping Characters)
如果你想显示 Markdown 语法中使用的特殊字符,例如 *、#、> 等,可以在字符前加上反斜杠 \ 来进行转义。
\* 这不会被渲染成斜体 \*
\# 这不会被渲染成一级标题
结论
Markdown 语法简洁而强大,掌握这些基本元素,你就可以在各种平台高效地创建和编辑文本内容。开云集团在内部文档管理和对外信息发布中,广泛采用 Markdown,以确保内容的一致性和易读性。
Sharing is caring!