# Markdown 语法完全指南

**Repository Path**: tinytaro/markdown-syntax-guide

## Basic Information

- **Project Name**: Markdown 语法完全指南
- **Description**: Markdown 语法完全指南
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Markdown 语法完全指南

## 1. 标题 (Headers)

# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)

> 💡 **提示**: 建议在 `#` 后添加空格，部分解析器要求必须有空格。

---

## 2. 文本格式 (Text Formatting)

### 2.1 基础样式

| 效果 | 语法 | 示例 |
| :--- | :--- | :--- |
| 粗体 | `**text**` 或 `__text__` | **粗体文本** |
| 斜体 | `*text*` 或 `_text_` | *斜体文本* |
| 粗斜体 | `***text***` | ***粗斜体文本*** |
| 删除线 | `~~text~~` | ~~删除线文本~~ |
| 下划线 | `<u>text</u>` (HTML) | <u>下划线文本</u> |
| 高亮 | `==text==` (部分支持) | ==高亮文本== |
| 行内代码 | `` `code` `` | `print("Hello")` |

### 2.2 组合样式

- **粗体 + 斜体**: ***文本***
- **粗体 + 删除线**: **~~文本~~**
- **斜体 + 删除线**: *~~文本~~*
- **全部组合**: ***~~文本~~***

---

## 3. 列表 (Lists)

### 3.1 无序列表

- 项目一
- 项目二
  - 嵌套项目 2.1
  - 嵌套项目 2.2
    - 三级嵌套 2.2.1
- 项目三

### 3.2 有序列表

1. 第一步
2. 第二步
3. 第三步
   1. 子步骤 3.1
   2. 子步骤 3.2
4. 第四步

> 📌 **注意**: 有序列表的数字可以全部写 `1.`，渲染时会自动递增。

### 3.3 任务列表 (Task List)

- [x] 已完成的任务
- [ ] 未完成任务一
- [ ] 未完成任务二
  - [x] 子任务已完成
  - [ ] 子任务未完成

---

## 4. 链接与图片 (Links & Images)

### 4.1 链接类型

| 类型 | 语法 | 示例 |
| :--- | :--- | :--- |
| 行内链接 | `[文字](URL)` | [GitHub](https://github.com) |
| 参考式链接 | `[文字][id]` + `[id]: URL` | [参考链接][1] |
| 自动链接 | `<URL>` | <https://example.com> |
| 邮件链接 | `<email>` | <test@example.com> |
| 锚点链接 | `[文字](#标题)` | [跳转到标题](#1-标题-headers) |

### 4.2 图片语法

| 类型 | 语法 | 示例 |
| :--- | :--- | :--- |
| 行内图片 | `![alt](URL)` | ![Logo](https://via.placeholder.com/100) |
| 参考式图片 | `![alt][id]` + `[id]: URL` | ![参考图片][2] |
| 带尺寸图片 (HTML) | `<img src="URL" width="100">` | <img src="https://via.placeholder.com/50" width="50"> |
| 链接图片 | `[![alt](URL)](链接)` | [![点击](https://via.placeholder.com/50)](https://example.com) |

---

## 5. 代码块 (Code Blocks)

### 5.1 行内代码

使用 `print()` 函数输出内容，或用 `git status` 查看状态。

### 5.2 代码块 (带语法高亮)

#### Python
```python
def hello(name: str) -> str:
    """返回问候语"""
    return f"Hello, {name}!"

if __name__ == "__main__":
    print(hello("World"))
```

#### JavaScript
```javascript
const greeting = (name) => {
    return `Hello, ${name}!`;
};

console.log(greeting("World"));
```

#### SQL
```sql
SELECT id, name, email 
FROM users 
WHERE status = 'active'
ORDER BY created_at DESC
LIMIT 10;
```

#### JSON
```json
{
    "name": "Markdown Guide",
    "version": "1.0.0",
    "features": ["headers", "lists", "code"],
    "active": true
}
```

#### Bash
```bash
#!/bin/bash
echo "Hello from Bash"
for i in {1..5}; do
    echo "Count: $i"
done
```

### 5.3 代码块 (无高亮)

```
这是纯文本代码块
没有语法高亮
适合展示配置内容
```

### 5.4 代码块中的特殊字符

```python
# 展示 Markdown 语法本身
print("# 这不是标题")
print("**这不是粗体**")
```

---

## 6. 引用块 (Blockquotes)

### 6.1 基础引用

> 这是一段引用文本。
> 可以跨越多行。

### 6.2 嵌套引用

> 第一层引用
> > 第二层引用
> > > 第三层引用

### 6.3 引用内包含其他元素

> ### 引用中的标题
> 
> 引用中的**粗体**和*斜体*
> 
> - 引用中的列表
> - 项目二
> 
> ```python
> print("引用中的代码")
> ```

### 6.4 引用与段落混合

> 这是引用段落。

这是普通段落。

> 这又是新的引用段落。

---

## 7. 表格 (Tables)

### 7.1 基础表格

| 姓名 | 年龄 | 城市 | 职业 |
| :--- | :---: | ---: | :---: |
| 张三 | 25 | 北京 | 工程师 |
| 李四 | 30 | 上海 | 设计师 |
| 王五 | 28 | 广州 | 产品经理 |

### 7.2 对齐方式说明

| 对齐 | 语法 | 效果 |
| :--- | :--- | :--- |
| 左对齐 | `:---` | 默认 |
| 居中对齐 | `:---:` | 居中 |
| 右对齐 | `---:` | 右对齐 |

### 7.3 复杂表格

| 功能 | 基础版 | 专业版 | 企业版 |
| :--- | :---: | :---: | :---: |
| 用户数 | 100 | 1,000 | ∞ |
| 存储 | 1GB | 10GB | 100GB |
| 支持 | 邮件 | 工单 | 24/7 电话 |
| 价格 | **免费** | `$9.99/月` | `$99.99/月` |

---

## 8. 分隔线 (Horizontal Rules)

---

以上是一条分隔线。

***

以上是星号分隔线。

___

以上是下划线分隔线。

---

## 9. 脚注 (Footnotes)

这是一个带有脚注的句子[^1]。

另一个需要说明的地方[^2]。

[^1]: 这是第一个脚注的内容，可以写很多解释性文字。
[^2]: 这是第二个脚注，支持**格式**和[链接](https://example.com)。

---

## 10. 数学公式 (LaTeX)

### 10.1 行内公式

质能方程是 $E = mc^2$，圆的面积是 $A = \pi r^2$。

### 10.2 块级公式

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

$$
\int_{a}^{b} f(x) dx = F(b) - F(a)
$$

### 10.3 复杂公式

$$
\begin{aligned}
f(x) &= x^2 + 2x + 1 \\
     &= (x + 1)^2
\end{aligned}
$$

---

## 11. 特殊语法扩展

### 11.1 键盘按键

<kbd>Ctrl</kbd> + <kbd>C</kbd> 复制  
<kbd>Ctrl</kbd> + <kbd>V</kbd> 粘贴  
<kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> 命令面板

---

## 12. 元数据 (Front Matter)

```yaml
---
title: Markdown 语法完全指南
author: 教学示例
date: 2024-01-01
tags: [markdown, 文档，语法]
category: 教程
---
```

> 📌 **注意**: Front Matter 需要放在文件最开头，用于静态网站生成器。

---