📝 Markdown语法指南

Markdown是一种轻量级标记语言，它允许您使用易读易写的纯文本格式编写文档。

✨ 为什么使用Markdown？

🔄 简单易学 - 语法简洁，容易掌握
🎨 专注内容 - 专注于内容而非格式
📱 跨平台 - 支持各种编辑器和平台
💾 纯文本 - 易于版本控制和分享
🔄 可转换 - 可转换为HTML、PDF等格式

📖 基础语法

1. 标题

使用 # 号可表示 1-6 级标题：

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

效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 段落和换行

段落之间用空行分隔，行末加两个空格可强制换行。

这是第一段文字。

这是第二段文字。
这是同一段的第二行。  
这是强制换行后的第三行。

效果：

这是第一段文字。

这是第二段文字。
这是同一段的第二行。
这是强制换行后的第三行。

3. 文字强调

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

效果：

斜体文本 或 斜体文本
粗体文本 或 粗体文本
粗斜体文本 或 粗斜体文本
~~删除线文本~~

4. 列表

无序列表

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

* 也可以使用星号
+ 或者加号

效果：

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

有序列表

1. 第一项
2. 第二项
3. 第三项
   1. 子项目3.1
   2. 子项目3.2

效果：

第一项
第二项
第三项
1. 子项目3.1
2. 子项目3.2

5. 链接和图片

链接

1
2
3

[链接文字](https://www.example.com)
[带标题的链接](https://www.example.com "链接标题")
<https://www.example.com>

效果：
链接文字
 带标题的链接
 https://www.example.com

图片

1 2	![图片描述](图片链接) ![示例图片](https://bu.dusays.com/2025/05/30/6839d54953864.jpg)

效果：
示例图片

6. 代码

行内代码

1	这是 `行内代码` 示例

效果：
这是 行内代码 示例

代码块

使用三个反引号包围代码块：

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

console.log(greet('World'));
```

效果：

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

console.log(greet('World'));

7. 引用

> 这是一个引用
> 可以包含多行内容
> 
> > 这是嵌套引用

效果：

这是一个引用
可以包含多行内容

这是嵌套引用

8. 表格

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:-------:|-------:|
| 左     |   中    |     右 |

效果：

列1	列2	列3
数据1	数据2	数据3
数据4	数据5	数据6

左对齐	居中对齐	右对齐
左	中	右

9. 分割线

1
2
3

---
***
___

效果：

10. 任务列表

1
2
3

- [x] 已完成任务
- [ ] 未完成任务
- [ ] 另一个未完成任务

效果：

[x] 已完成任务
[ ] 未完成任务
[ ] 另一个未完成任务

🚀 高级语法

1. 脚注

1
2
3

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

[^1]: 这是脚注的内容。

2. 缩写

*[HTML]: HyperText Markup Language
*[W3C]: World Wide Web Consortium

HTML 和 W3C 将会有下划线提示。

3. 定义列表

苹果
:   红色的水果

橙子
:   橙色的水果

💡 实用技巧

1. 转义字符

当您需要显示Markdown语法字符时，使用反斜杠转义：

1 2	\这不是斜体\ \#这不是标题

2. HTML支持

Markdown支持内嵌HTML：

1
2
3

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

3. 数学公式（如果支持）

行内公式：$E = mc^2$

块级公式：
$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$

📚 常用工具推荐

在线编辑器

Typora - 所见即所得编辑器
Mark Text - 实时预览编辑器
Dillinger - 在线Markdown编辑器

浏览器扩展

Markdown Viewer - 浏览器内查看.md文件
Markdown Here - 邮件中使用Markdown

桌面应用

Obsidian - 知识管理工具
Notion - 支持Markdown的笔记工具
Bear - Mac平台优秀的Markdown编辑器

🎯 最佳实践

保持简洁 - 不要过度使用格式
一致性 - 在同一文档中保持格式一致
可读性 - 原始文本也应该易于阅读
预览检查 - 经常预览确保格式正确
版本控制 - 利用纯文本的优势进行版本管理

📖 参考资源

希望这个Markdown语法指南对您有帮助！开始您的Markdown之旅吧！ 🚀