Markdown 写作完全指南 - 从入门到精通

Markdown 是一种轻量级标记语言，被广泛应用于博客写作、文档编写、笔记记录等场景。本文带你从零掌握 Markdown 的全部语法。

一、基础语法

1.1 标题

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果：

一级标题

二级标题

三级标题

技巧：一级标题一般只用于文章标题，正文从二级标题开始。

1.2 文字样式

1
2
3
4
5
**加粗文字**
*斜体文字*
***加粗斜体***
~~删除线~~
`行内代码`

效果：

加粗文字 | 斜体文字 | 加粗斜体 | 删除线 | 行内代码

1.3 段落与换行

1
2
3
4
5
6
这是第一段。

这是第二段（空一行形成新段落）

这是同一段，
换行不加空行（某些渲染器需要行尾加两个空格）

1.4 列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 无序列表
- 项目一
- 项目二
  - 子项目 2.1
  - 子项目 2.2
- 项目三

# 有序列表
1. 第一步
2. 第二步
   1. 子步骤 2.1
   2. 子步骤 2.2
3. 第三步

# 任务列表
- [x] 已完成
- [ ] 待完成
- [ ] 计划中

效果：

  • 项目一
  • 项目二
    • 子项目 2.1
    • 子项目 2.2
  • 项目三
  1. 第一步
  2. 第二步
    1. 子步骤 2.1
    2. 子步骤 2.2
  3. 第三步
  • 已完成
  • 待完成
  • 计划中

二、链接与图片

2.1 链接

1
2
3
4
5
[链接文字](https://example.com)
[链接文字](https://example.com "鼠标悬停提示")
[引用式链接][id]

[id]: https://example.com "可选标题"

2.2 图片

1
2
3
4
5
![替代文字](图片地址)
![替代文字](图片地址 "图片标题")

# 带链接的图片
[![替代文字](图片地址)](链接地址)

2.3 图片尺寸控制

1
2
3
4
5
6
7
# HTML 方式（推荐）
<img src="/img/example.jpg" width="300" alt="示例">

# 居中显示
<div align="center">
  <img src="/img/example.jpg" width="50%" alt="示例">
</div>

三、引用与代码

3.1 引用

1
2
3
4
5
6
7
8
> 一级引用
>> 二级引用
>>> 三级引用

> **提示**：引用中可以包含其他 Markdown 元素
> - 列表
> - `代码`
> - [链接](https://example.com)

效果：

一级引用

二级引用

三级引用

3.2 代码块

1
2
3
4
5
6
7
8
9
10
11
12
```语言名称
代码内容
```

```python
def hello():
    print("Hello, World!")
```

```javascript
console.log("Hello, World!");
```

3.3 行内代码

1
使用 `print()` 函数输出内容

四、表格

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

效果：

左对齐 居中 右对齐
内容 内容 内容
长内容 内容 内容

五、分隔线与脚注

5.1 分隔线

1
2
3
---
***
___

5.2 脚注

1
2
3
这是一个需要脚注的句子[^1]

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

六、高级语法

6.1 HTML 混用

1
2
3
4
5
6
7
8
9
10
11
12
<div align="center">

## 居中的标题

</div>

<details>
<summary>点击展开</summary>

这里是被折叠的内容

</details>

6.2 表情符号

1
:smile: :heart: :thumbsup: :rocket:

6.3 数学公式（KaTeX / MathJax）

1
2
3
4
5
6
7
# 行内公式
$E = mc^2$

# 块级公式
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

6.4 流程图（Mermaid）

1
2
3
4
5
6
7
```mermaid
graph TD
    A[开始] --> B{判断}
    B -->|是| C[执行]
    B -->|否| D[结束]
    C --> D
```

七、编辑器推荐

编辑器 特点 平台
VS Code 免费、插件丰富、功能强大 全平台
Typora 所见即所得、简洁美观 全平台
Obsidian 双向链接、知识管理 全平台
Notion 在线协作、功能全面 Web/全平台

八、实用技巧

8.1 快速创建表格

使用在线工具：

8.2 图片管理

1
2
3
4
5
# 推荐：统一存放图片到 source/img/ 目录
![示例](/img/example.png)

# 或使用图床
![示例](https://cdn.example.com/img/example.png)

8.3 文章模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
---
title: 文章标题
date: 2026-06-18 10:00:00
tags:
  - 标签1
  - 标签2
categories:
  - 分类
description: 文章描述
---

## 前言

## 正文

## 总结

## 参考

总结

Markdown 的语法简洁而强大，掌握它只需要半小时，但能让你的写作效率大幅提升。

记住核心原则：用最简单的语法，写最清晰的内容。

祝你写作愉快！