1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Markdown 完整语法指南

> Markdown 是一种轻量级标记语言，让你用纯文本格式编写文档。

---

## 一、标题

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

效果：

一级标题

二级标题

三级标题

二、段落与换行

1
2
3
4
这是第一段。直接回车不会换行，需要在行尾加两个空格  
才能强制换行。

空一行才能开始新段落。

三、字体样式

语法 效果
**粗体** 粗体
*斜体* 斜体
***粗斜体*** 粗斜体
~~删除线~~ 删除线
`行内代码` 行内代码

四、列表

无序列表

1
2
3
4
5
- 项目一
- 项目二
  - 子项目（前面加两个空格或Tab）
  - 子项目
- 项目三
  • 项目一
  • 项目二
    • 子项目
    • 子项目
  • 项目三

有序列表

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

五、链接与图片

链接

1
2
[链接文字](https://www.example.com)
[带标题的链接](https://www.example.com "鼠标悬停显示")

链接文字

图片

1
2
3
4
5
![图片描述](图片地址)
![Logo](https://www.example.com/logo.png "可选标题")

<!-- 本地图片 -->
![截图](./images/screenshot.png)

示例图片

链接图片（点击图片跳转）

1
[![图片描述](图片地址)](跳转链接)

六、引用

1
2
3
> 这是一段引用文字
> 可以有多行
>> 嵌套引用

这是一段引用文字
可以有多行

嵌套引用

七、代码块

行内代码

1
使用 `pip install django` 安装

使用 pip install django 安装

代码块（推荐用三个反引号）

1
2
3
4
```python
def hello():
    print("Hello World")
```
1
2
def hello():
    print("Hello World")

指定语言高亮

1
2
3
4
5
```javascript
function greet(name) {
    return `Hello, ${name}!`;
}
```
1
2
3
function greet(name) {
    return `Hello, ${name}!`;
}

八、表格

1
2
3
4
5
| 姓名 | 年龄 | 城市 |
|:---|:---:|---:|
| 左对齐 | 居中 | 右对齐 |
| 张三 | 25 | 北京 |
| 李四 | 30 | 上海 |
姓名 年龄 城市
左对齐 居中 右对齐
张三 25 北京
李四 30 上海

九、分隔线

1
2
3
4
5
---
或
***
或
___

十、任务列表

1
2
3
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项
  • 已完成任务
  • 未完成任务
  • 待办事项

十一、脚注

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

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

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

十二、特殊符号

1
2
3
4
5
6
7
<!-- HTML 标签可用 -->
<center>居中文字</center>

<!-- 转义特殊字符 -->
\* 不是斜体 \*
\` 不是代码 \`
\\ 反斜杠

十三、文档元数据（YAML Front Matter）

1
2
3
4
5
6
7
8
---
title: 文档标题
author: 作者名
date: 2024-01-01
tags: [markdown, tutorial]
---

正文开始...

十四、常用技巧

折叠内容（HTML）

1
2
3
4
5
6
7
<details>
<summary>点击展开</summary>

隐藏的内容在这里
- 支持 Markdown
- 列表等
</details>
点击展开

隐藏的内容在这里

  • 支持 Markdown
  • 列表等

表情符号

1
:smile: :heart: :thumbsup:

😄 ❤️ 👍

推荐工具

工具 用途
Typora 所见即所得编辑器
VS Code + Markdown插件 代码编辑器
Obsidian 知识库管理
Notion 协作笔记
GitHub/GitLab 展示 Markdown

快速参考卡片

1
2
3
# 标题        **粗体**      *斜体*      `代码`
[链接](url)   ![图](url)    > 引用      - 列表
| 表 | 格 |    --- 分隔线   ` `` ` 代码块

提示：Markdown 兼容性很好，GitHub、GitLab、Notion、语雀等平台都支持！


---

## 保存为 `.md` 文件

1. 复制以上内容
2. 粘贴到文本编辑器（VS Code、Typora、记事本等）
3. 保存为 `markdown-guide.md`

需要针对特定平台（GitHub、VuePress、MkDocs）的扩展语法吗？