Markdown 语法学习指南

本指南按照使用频率从高到低排列，每个语法都提供了实际案例和效果展示。

1. 标题（最常用）

用于创建文档结构，支持 6 级标题。

语法：

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 段落和换行

语法：

这是第一个段落。

这是第二个段落。
段落内使用两个空格+回车
可以实现强制换行。

效果：
这是第一个段落。

这是第二个段落。
段落内使用两个空格+回车
可以实现强制换行。

3. 强调文本

语法：

*斜体文本* 或 _斜体文本_
**粗体文本** 或 __粗体文本_
***粗斜体文本***

效果：
斜体文本 或 斜体文本
粗体文本 或 _粗体文本
粗斜体文本

4. 列表

无序列表

语法：

* 项目一
- 项目二
+ 项目三
  * 子项目一
  * 子项目二

效果：

  • 项目一
  • 项目二
  • 项目三
    • 子项目一
    • 子项目二

有序列表

语法：

1. 第一步
2. 第二步
3. 第三步
   1. 子步骤一
   2. 子步骤二

效果：

  1. 第一步
  2. 第二步
  3. 第三步
    1. 子步骤一
    2. 子步骤二

5. 链接

内联链接

语法：

[Google](https://www.google.com)
[GitHub](https://github.com "访问GitHub")

效果：
Google
GitHub

参考式链接

语法：

这是一个[参考链接][ref]，这是另一个[链接][1]。

[ref]: https://example.com "参考链接标题"
[1]: https://github.com

效果：
这是一个参考链接，这是另一个链接。

6. 图片

语法：

![替代文字](图片URL)
![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png "GitHub Logo")

效果：
替代文字
GitHub Logo

7. 代码

行内代码

语法：

使用 `print("Hello, World!")` 函数输出文本。

效果：
使用 print("Hello, World!") 函数输出文本。

代码块

简单代码块

语法：

```
function hello() {
    console.log("Hello World!");
}
```

效果：

function hello() {
    console.log("Hello World!");
}

语法高亮代码块

语法：

```javascript
function greet(name) {
    return `Hello, ${name}!`;
}

const message = greet("World");
console.log(message);
```

```python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)
```

效果：

function greet(name) {
    return `Hello, ${name}!`;
}

const message = greet("World");
console.log(message);

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

8. 引用

语法：

> 这是一段引用文本。
>
> 可以包含多行引用。
>> 嵌套引用也是支持的。

效果：

这是一段引用文本。

可以包含多行引用。

嵌套引用也是支持的。

9. 分割线

语法：

***

---

___

效果：

10. 表格

语法：

| 姓名 | 年龄 | 职业 |
|------|------|------|
| 张三 | 25   | 工程师 |
| 李四 | 30   | 设计师 |
| 王五 | 28   | 产品经理 |

| 对齐方式 | 左对齐 | 居中对齐 | 右对齐 |
|:---------|:-------|:--------:|-------:|
| 内容     | 内容   |   内容   |   内容 |
| 内容     | 内容   |   内容   |   内容 |

效果：

姓名 年龄 职业
张三 25 工程师
李四 30 设计师
王五 28 产品经理
对齐方式 左对齐 居中对齐 右对齐
内容 内容 内容 内容
内容 内容 内容 内容

11. 转义字符

语法：

\* 不是斜体 \*
\# 不是标题 \#
\[ 不是链接的方括号 \[

效果：
* 不是斜体 *
# 不是标题 #
[ 不是链接的方括号 [

12. 任务列表

语法：

- [x] 完成的任务
- [ ] 未完成的任务
- [ ] 另一个待办事项

效果：

  • [x] 完成的任务
  • [ ] 未完成的任务
  • [ ] 另一个待办事项

13. 脚注

语法：

这里有一个脚注[^1]和另一个脚注[^note]。

[^1]: 这是第一个脚注
[^note]: 这是命名的脚注，可以包含更详细的说明和[链接](https://example.com)。

效果：
这里有一个脚注^1和另一个脚注^note。

14. 删除线

语法：

~~这段文本被删除了~~

效果：
这段文本被删除了

15. 行内 HTML

语法：

使用 HTML 可以实现更多样式：<u>下划线文本</u>

<div style="color: red;">
  这段文字是红色的
</div>

<kbd>Ctrl</kbd> + <kbd>C</kbd> 复制

效果：
使用 HTML 可以实现更多样式：下划线文本

这段文字是红色的

Ctrl + C 复制

16. 定义列表

语法：

术语
: 定义描述

另一个术语
: 另一个定义描述
  可以包含多行

效果：
术语
: 定义描述

另一个术语
: 另一个定义描述
可以包含多行

17. Emoji 表情

语法：

😀 😃 😄 😁 😆
:heart: :thumbsup: :check_mark:

效果：
😀 😃 😄 😁 😆
❤️ 👍 ✅

实用技巧

1. 自动生成目录

<!-- 在支持TOC的Markdown解析器中 -->
[TOC]

2. 锚点链接

### 快速跳转 {#jump}

跳转到[快速跳转](#jump)

3. 混合使用

> **提示**: 你可以在引用中使用 `代码` 和 **粗体** 文本。
>
> 还可以包含列表：
> - 项目一
> - 项目二

效果：

提示: 你可以在引用中使用 代码 和 粗体 文本。

还可以包含列表：

  • 项目一
  • 项目二

常见问题

Q: 如何在表格中使用竖线 |？

A: 使用转义字符 \| 或者使用HTML实体 &#124;

Q: 如何在代码块中使用反引号？

A: 使用多个反引号包围代码块，或者使用转义字符 ```

Q: 如何创建空链接？

A: 使用 []() 或 [](#) 创建空链接

在线工具推荐

  1. 编辑器: Typora - 优秀的实时预览编辑器
  2. 在线编辑: Markdown Editor - 在线实时预览
  3. 转换工具: Pandoc - 强强的文档转换工具
  4. 语法检查: Markdownlint - Markdown 语法检查

学习建议

  1. 从基础开始: 先掌握标题、段落、列表、链接等常用语法
  2. 多练习: 在实际项目中使用 Markdown 记录文档
  3. 查阅参考: 遇到问题时查看 CommonMark 规范
  4. 扩展学习: 了解不同平台（GitHub、GitLab、Typora等）的扩展语法

记住：Markdown 的核心思想是"易读易写"，保持简洁是最重要的原则！