Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成结构化的HTML格式。GitHub作为一个全球最大的代码托管平台，提供了对Markdown的广泛支持。本文将详细介绍如何在GitHub上使用Markdown，以便你轻松编写和展示代码与文档。
1. 基础语法
Markdown的语法相对简单，以下是几种常用的语法：
1.1 标题
使用#来创建标题，其中#的数量决定了标题的层级。
# 一级标题
## 二级标题
### 三级标题
1.2 段落
直接输入文本即可创建段落，段落之间需要空行分隔。
1.3 强调
使用星号或下划线来表示文本的强调。
*斜体*
**粗体**
1.4 列表
使用-、*或+来创建无序列表，使用数字和句点来创建有序列表。
- 列表项1
- 列表项2
- 列表项3
1. 列表项1
2. 列表项2
3. 列表项3
1.5 链接
使用方括号和圆括号来创建链接。
[链接文本](链接地址)
1.6 图片
使用感叹号、方括号和圆括号来插入图片。
2. 在GitHub上编写Markdown
在GitHub上，你可以使用Markdown来编写多种类型的文档，如下：
2.1 README文件
README文件是每个GitHub仓库的第一页，用于描述仓库的内容和功能。以下是一个简单的README文件示例：
# 项目名称
这是一个关于Markdown的GitHub仓库。
## 功能
- Markdown基础语法
- GitHub上使用Markdown
## 安装
1. 克隆仓库
2. 编辑文件
3. 提交更改
## 联系方式
- QQ：12345678
- 邮箱：example@example.com
2.2 文档
在GitHub仓库中，你可以创建新的Markdown文件来编写详细的文档。以下是一个示例：
# Markdown实用指南
## 1. 基础语法
Markdown的语法相对简单，本文将介绍一些常用的语法。
## 2. 在GitHub上使用Markdown
在GitHub上，你可以使用Markdown来编写各种类型的文档。
## 3. 总结
Markdown是一种轻量级标记语言，它可以帮助你轻松地编写和展示文档。
3. 展示代码
在Markdown中，你可以使用代码块来展示代码。以下是几种代码块的使用方法：
3.1 单行代码
使用反引号来表示单行代码。
`代码`
3.2 多行代码
使用三个反引号来创建多行代码块，并指定语言。
```python
def hello_world():
print("Hello, World!")
### 3.3 高亮显示
使用两个反引号来创建高亮显示的代码块。
```markdown
Hello, World!
4. 总结
Markdown在GitHub上具有广泛的应用，它可以帮助你轻松地编写和展示代码与文档。通过掌握Markdown的基础语法和GitHub的使用技巧，你可以更好地利用这个强大的平台来提高工作效率。