Markdown基础语法

1. 标题

Markdown 使用 # 来表示标题。根据 # 的数量，决定标题的级别

# 一级标题 - 用于页面主标题
## 二级标题 - 用于主要章节  
### 三级标题 - 用于子章节
#### 四级标题 - 用于细分内容
##### 五级标题 - 很少使用
###### 六级标题 - 很少使用

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 段落和换行

普通文本之间空一行即可创建段落。换行使用两个空格后按 Enter 键

这是第一段文本。

这是第二段文本。

这是第三段文本，  
它是紧接着上一段换行的。

这是第一段文本。

这是第二段文本。

这是第三段文本，
它是紧接着上一段换行的。

3. 文本强调

通过 *或 _ 来表示斜体和粗体

• 斜体：使用单个星号 * 或单个下划线 _
• 粗体：使用两个星号 ** 或两个下划线 __
• 斜体和粗体：使用三个星号 *** 或三个下划线 ___

**粗体文本** - 重要内容
*斜体文本* - 强调内容  
***粗斜体*** - 特别重要
~~删除线~~ - 过时内容
`代码片段` - 技术术语

粗体文本 - 重要内容
斜体文本 - 强调内容
粗斜体 - 特别重要
删除线 - 过时内容
代码片段 - 技术术语

4. 列表

---

• 无序列表

  无序列表使用 -、+ 或 * 作为列表项标记。

- 🎯 使用emoji增加视觉效果
+ ✨ 保持统一的符号风格
* 📚 内容简洁明了
- 🔧 合理使用图标

• 🎯 使用emoji增加视觉效果

• ✨ 保持统一的符号风格

• 📚 内容简洁明了

• 🔧 合理使用图标

---

• 有序列表

  有序列表使用数字和点号（1.）表示

1. 🚀 第一步：准备工作
2. 💻 第二步：开始编写
3. 🎉 第三步：完成发布

1. 🚀 第一步：准备工作
2. 💻 第二步：开始编写
3. 🎉 第三步：完成发布

---

• 嵌套列表

  通过在子列表前添加空格或制表符来创建嵌套列表

- 主要内容
  - 子内容1
  - 子内容2
    - 更深层内容
    - 另一个深层内容
  - 子内容3
- 另一个主要内容

• 主要内容
  • 子内容1
  • 子内容2
    • 更深层内容
    • 另一个深层内容
  • 子内容3
• 另一个主要内容

5. 链接

Markdown 支持两种方式来插入链接：

普通链接

• 行内式链接：[链接文本](URL)

[百度](https://www.baidu.com)

百度

• 引用式链接：[链接文本][1] 和 [1]: URL

[百度][1]
[1]: https://www.baidu.com

百度

带标题的链接

• 给链接增加 Title

  链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔

[百度](https://www.baidu.com "百度一下，你就知道")

百度

• 禁用自动URL链接

  如果您不希望自动链接URL，则可以通过将URL表示为带反引号的代码来删除该链接

`http://www.baidu.com`

http://www.baidu.com

6. 图片

插入图片和链接的语法类似，区别在于图片前面有一个感叹号 !,括号里的链接后可以增加一个可选的图片标题文本

![图片描述](图片URL" 图片title")

• 链接图片

  给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中

[![岩石图片](../img/shiprock.jpg "Shiprock")](https://xxxx.cn)

• HTML 方式控制图片

<img src="图片路径" alt="图片描述" width="300" height="200">

<div align="center">
  <img src="图片路径" alt="图片描述" width="400">
</div>

7. 引用

引用使用 > 来标识

简单引用：

> 这是一个简单的引用块

这是一个简单的引用块

多行引用：

> 这是引用的第一行
> 
> 这是引用的第二段  
> 最后一行内容

这是引用的第一行

这是引用的第二段
最后一行内容

嵌套引用：

> 外层引用内容
> 
> > 这是内层引用
> > 可以有多行
> 
> 回到外层引用

外层引用内容

这是内层引用 可以有多行

回到外层引用

8. 代码

• 行内代码

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

使用 `git commit` 命令可以提交代码

使用 git commit 命令可以提交代码

• 要将链接表示为代码，请在方括号中添加反引号

I love supporting the **[EFF](https://eff.org)**.  
This is the *[baidu](https://www.baidu.com)*.  
See the section on [`code`](#code).

I love supporting the EFF.
This is the baidu.
See the section on code.

• 块级代码

  使用三个反引号 （```） 或者三个波浪号（~~~）来表示代码块，可以指定语言类型来启用语法高亮

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

9. 水平分割线

水平线使用三个或更多的星号(***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容

***
---
_________

10. 表格

Markdown 也支持表格，表头和表体之间用 | 和 - 进行分隔,如使用三个或多个连字符（---）创建每列的标题，并使用管道（|）分隔每列

| 列1 | 列2 | 列3 |
|:---|:---:|---:|
| 左对齐 | 居中 | 右对齐 |
| 内容1 | 内容2 | 内容3 |
| 长内容展示 | 中等内容 | 短内容 |

列1	列2	列3
左对齐	居中	右对齐
内容1	内容2	内容3
长内容展示	中等内容	短内容

• 对齐

  通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心

| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

Syntax	Description	Test Text
Header	Title	Here's this
Paragraph	Text	And more

表格内使用格式

| 功能 | 描述 | 状态 |
|:---:|:---:|:---:|
| **搜索** | 全文搜索功能 | ✅ 完成 |
| **标签** | 文章分类标签 | 🚧 进行中 |
| **评论** | 用户评论系统 | ⏳ 待开发 |
| `代码` | 代码高亮显示 | ❌ 未开始 |

功能	描述	状态
搜索	全文搜索功能	✅ 完成
标签	文章分类标签	🚧 进行中
评论	用户评论系统	⏳ 待开发
代码	代码高亮显示	❌ 未开始

11. 特殊字符

如果你需要插入特殊字符（如 #、* 等）而不被解释为 Markdown 语法，可以使用反斜杠 \ 来转义

\# 这是一个井号
\* 这是一个星号

12. 自定义链接锚点

在 Markdown 中，你可以为标题添加自定义锚点，然后在文档内创建链接

## 章节标题 {#custom-id}

[跳转到自定义标题](#custom-id)

13. 任务列表

任务列表用于表示待办事项。每一项任务使用 [ ] 和 [x]来表示未完成和已完成任务

- [x] 完成的任务
- [x] 另一个完成的任务
- [ ] 待完成的任务
- [ ] 未来的计划

• 完成的任务
• 另一个完成的任务
• 待完成的任务
• 未来的计划

14. 表情符号

Markdown 中可以通过使用 :emoji_name: 来插入表情符号

:smile: :heart: :thumbsup:
真好笑！ :joy:

15.删除线

若要删除词语，请在词语前后使用两个波浪号(~~)

~~世界是平坦的。~~ 我们现在知道世界是圆的。

世界是平坦的。 我们现在知道世界是圆的。