Markdown语法入门与进阶教程

Markdown 是一种轻量级标记语言，广泛应用于文档编写、项目 README、博客文章、技术文档等场景。本文将介绍 Markdown 的基本语法和进阶用法，帮助你快速上手并掌握实用技巧。

---

🧱 1. 基础语法

1.1 标题（Header）

使用 # 表示标题等级，1~6级：

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

1.2 段落与换行

段落之间使用空行分隔。
强制换行使用两个空格 + 回车。

这是第一段。

这是第二段。  
这是第二段中的第二行（强制换行）

1.3 强调（加粗、斜体、删除线）

**加粗文本** 或 __加粗文本__
*斜体文本* 或 _斜体文本_
~~删除线~~

1.4 列表

无序列表：

- 项目1
- 项目2
  - 子项2.1
  - 子项2.2

有序列表：

1. 第一项
2. 第二项
   1. 子项2.1
   2. 子项2.2

1.5 链接与图片

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

![图片描述](https://example.com/image.png)

1.6 引用

> 这是一段引用内容。
>> 多重引用

1.7 分隔线

---

---

🧑‍💻 2. 代码与代码块

2.1 行内代码

使用 `printf()` 打印输出。

2.2 多行代码块（缩进或反引号）

方法一：使用三个反引号（推荐）

<pre> ```python def hello(): print("Hello, Markdown!") ``` </pre>

方法二：缩进四个空格（不推荐）

    def hello():
        print("Hello, world!")

---

🧠 3. 表格（Table）

| 姓名 | 年龄 | 城市 |
|------|------|------|
| 张三 |  25  | 北京 |
| 李四 |  30  | 上海 |

对齐方式：

| 左对齐 | 居中 | 右对齐 |
|:------|:----:|------:|
| 内容1 | 内容2 | 内容3 |

---

📌 4. 进阶技巧

4.1 自动目录（部分 Markdown 引擎支持）

[TOC]

在支持 TOC（Table of Contents）的平台上，如 GitHub Pages、Typora、Gitea，会自动生成目录。

4.2 任务列表（GitHub 等支持）

- [x] 已完成任务
- [ ] 未完成任务

4.3 HTML 混用

Markdown 支持直接嵌入 HTML：

<b>加粗</b> <i>斜体</i> <u>下划线</u>

4.4 注释

<!-- 这是一个注释 -->

4.5 脚注（部分解析器支持）

Markdown[^1] 是一种轻量标记语言。

[^1]: Markdown 是由 John Gruber 创建的。

---

🛠 5. 推荐工具

• 编辑器：
  • Typora（本地写作，所见即所得）
  • Obsidian（知识管理）
  • VS Code + Markdown 插件（开发文档）
• 在线平台：
  • GitHub
  • Gitee
  • CSDN / 简书
  • StackEdit / Dillinger

---

📚 6. 示例：项目 README 模板

# 项目名称

## 简介
这是一个基于 Markdown 编写的示例项目。

## 特性
- 简单易用
- 支持多平台
- 易于维护

## 快速开始

```bash
git clone https://github.com/your-repo.git
cd your-repo
npm install
npm run start