Markdown 语法基础笔记

既然已经开始写博客或者记学习笔记，那么 Markdown 基本就是绕不过去的工具。它的优点很明显：

  • 语法简单
  • 可读性强
  • 纯文本，方便版本管理
  • 适合博客、文档、项目说明和技术笔记

这篇文章按“最常用 -> 稍进阶 -> 博客常见扩展”的顺序，把 Markdown 常用语法整理成一份可以反复查阅的笔记。

[!TIP]

本文中的符号说明只是为了强调格式。真正写 Markdown 时，不需要把解释性的引号一起打出来。

一、标题

Markdown 一共支持 6 级标题，用 # 的数量来区分层级。

写法：

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

效果说明：

  • # 越少，标题级别越高
  • 一级标题通常在一篇文章里只出现一次
  • 正文结构一般从二级标题开始更清晰

示例：

1
2
3
# Markdown 语法基础笔记
## 标题
### 代码块

二、段落与换行

Markdown 的正文其实就是普通文本，但换行规则和 Word 不完全一样。

1. 分段

两个段落之间通常空一行：

1
2
3
这是第一段。

这是第二段。

2. 换行

如果只是直接回车，很多 Markdown 渲染器不会立刻换行。
常见做法有两种：

1
2
第一行后面加两个空格  
第二行

或者直接空一行分段。

三、强调语法

1. 加粗

1
**这是加粗**

效果：这是加粗

2. 斜体

1
*这是斜体*

效果：这是斜体

3. 粗斜体

1
***这是粗斜体***

效果：这是粗斜体

4. 删除线

1
~~这段内容被删除~~

效果：这段内容被删除

5. 行内代码

1
使用 `printf()` 输出内容

效果：使用 printf() 输出内容

四、引用

引用使用 > 符号。

1
> 这是一段引用

效果：

这是一段引用

也可以多层嵌套：

1
2
> 第一层引用
>> 第二层引用

常见用途：

  • 引用说明
  • 标记注意事项
  • 摘录定义或结论

五、列表

Markdown 中最常见的是三类列表：有序列表、无序列表和任务列表。

1. 有序列表

写法：

1
2
3
1. 吃饭
2. 学习
3. 睡觉

效果：

  1. 吃饭
  2. 学习
  3. 睡觉

2. 无序列表

写法：

1
2
3
- 苹果
- 香蕉
- 橘子

效果：

  • 苹果
  • 香蕉
  • 橘子

3. 任务列表

写法：

1
2
- [ ] 复习 Markdown
- [x] 写完今天的笔记

效果：

  • 复习 Markdown
  • 写完今天的笔记

任务列表在写 To-do、学习计划和项目进度时很方便。

六、代码块

技术博客里最常用的就是代码块。

1. 单行代码

使用一对反引号包裹：

1
`Hello world`

2. 多行代码块

使用三个反引号：

1
2
3
4
5
6
7
```c
#include <stdio.h>

int main() {
    printf("Hello world!\n");
    return 0;
}
1
2
3
4
5
6
7
8
9
10

效果如下：

```c
#include <stdio.h>

int main() {
    printf("Hello world!\n");
    return 0;
}

代码块后面加语言名，可以启用语法高亮。常见语言：

  • c
  • cpp
  • python
  • java
  • bash
  • json
  • yaml
  • asm

七、链接

1. 行内链接

写法：

1
[我的博客](https://www.flying-hy.xyz/ "欢迎访问我的博客")

效果：

我的博客

2. 引用式链接

当一篇文章里多次使用同一个链接时，引用式更整洁。

写法：

1
2
3
[我的博客][blog]

[blog]: https://www.flying-hy.xyz/ "这是我的博客"

效果：

我的博客

3. 页内跳转

很多 Markdown 渲染器支持目录标题跳转：

1
[跳到“代码块”部分](#六代码块)

不同博客主题对标题锚点的处理方式可能略有差异，发布后最好实际点一下确认。

八、图片

图片语法和链接非常相似，只是前面多一个 !。

1
![图片描述](https://example.com/demo.png)

如果是博客本地图片，也常见这种写法：

1
![示意图](/img/demo.png)

建议：

  • [] 里尽量写有意义的描述文本
  • 本地图片统一管理目录，后期维护更方便

九、表格

Markdown 表格适合整理对比信息。

写法：

1
2
3
| 姓名 | 年龄 | 成绩 |
| :--- | :---: | ---: |
| HY | 19 | 100 |

效果：

姓名 年龄 成绩
HY 19 100

对齐方式：

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

十、分隔线

分隔线常用于切分文章结构。

1
---

或者：

1
***

效果：

如果一篇文章内容比较长，合理使用分隔线能让结构更清晰。

十一、脚注

脚注适合补充说明，不会打断正文阅读节奏。

写法：

1
2
3
Markdown 很适合写博客[^1]

[^1]: 因为它简洁、可读、易维护。

效果：

Markdown 很适合写博客^1

十二、数学公式

许多博客系统支持 LaTeX 数学公式。

1. 行内公式

1
$E=mc^2$

效果：$E=mc^2$

2. 独立公式块

1
2
3
$$
f(x)=\sqrt{3x-1}+(1+x)^2
$$

效果：

$$
f(x)=\sqrt{3x-1}+(1+x)^2
$$

如果你需要更系统地学公式语法，核心其实是 LaTeX 表达式，而不是 Markdown 本身。

十三、转义字符

有些字符本身就是 Markdown 的语法符号，如果你只想显示它本身，需要加反斜杠转义。

例如：

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

效果：

*不是斜体*
# 不是标题

十四、HTML 标签扩展

Markdown 本身不覆盖所有排版功能，所以很多平台都允许混用少量 HTML。

1. 下划线

1
<u>带下划线的文字</u>

效果：带下划线的文字

2. 上标与下标

1
2
x<sup>2</sup>
H<sub>2</sub>O

效果：

x2
H2O

3. 高亮

1
<mark>高亮内容</mark>

效果：高亮内容

4. 设置字体颜色

1
<font color="red">红色文字</font>

效果：红色文字

[!WARNING]

一些 HTML 标签在不同平台的支持度不同，尤其是颜色和 iframe。发博客前最好预览确认。

十五、常见颜色值

如果你的博客主题支持 HTML 颜色标签，可以参考下面这些颜色名：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
maroon
grey
silver
lightgrey
HotPink
DeepPink
VioletRed
Purple
navy
Blue
DeepSkyBlue
LightSkyBlue
aqua
DarkTurquoise
LightSeaGreen
YellowGreen
LawnGreen
GreenYellow
Yellow
Tomato
red
fuchsia
MediumOrchid
DarkViolet

不过在技术文章里，颜色通常只建议少量使用，不然容易影响阅读。

十六、嵌入页面或视频

有些博客平台允许使用 iframe 嵌入页面或视频。

示例：

1
2
3
4
5
6
7
8
9
<iframe
  width="600"
  height="400"
  src="//player.bilibili.com/player.html?bvid=BV1JA411h7Gw"
  scrolling="no"
  border="0"
  frameborder="no"
  allowfullscreen="true">
</iframe>

注意：

  • 不同平台可能会过滤 iframe
  • 出于安全策略，部分站点不允许被嵌入
  • 如果嵌入失败，优先考虑直接放链接

十七、YAML Front Matter

如果你在用 Hexo、Jekyll、VuePress 这类静态站点工具，文章顶部通常会有一段 Front Matter。

例如：

1
2
3
4
5
6
7
---
title: Markdown 语法基础笔记
date: 2025-11-26 11:22:21
tags: [Markdown, 写作]
categories: 技术笔记
description: 一篇 Markdown 基础整理
---

常见作用：

  • 设置标题
  • 设置发布时间
  • 设置标签和分类
  • 设置封面图、摘要等元信息

十八、博客写作建议

真正写博客时，Markdown 不只是“会语法”就够了，还要注意排版质量。

建议：

  • 一级标题只保留一个
  • 二级标题作为主要结构
  • 代码块一定标明语言
  • 表格不要太宽，否则手机端体验差
  • 长段落适当拆开，提升可读性
  • 图片尽量加描述文字
  • 同类信息尽量统一格式

十九、常见语法速查表

功能 写法
一级标题 # 标题
二级标题 ## 标题
加粗 **文字**
斜体 *文字*
删除线 ~~文字~~
行内代码 `code`
引用 > 引用内容
无序列表 - 内容
有序列表 1. 内容
任务列表 - [ ] 内容
代码块 ```语言
链接 [文字](链接)
图片 ![描述](链接)
表格 `
分隔线 ---
脚注 [^1]
数学公式 $公式$ 或 $$公式$$

二十、总结

Markdown 最吸引人的地方，不是它功能有多复杂，而是它足够简单却足够实用。

对于写博客的人来说，最常用的其实就这几类：

  • 标题
  • 列表
  • 引用
  • 代码块
  • 图片
  • 链接
  • 表格

先把这些高频语法用熟，再按需补充公式、脚注、HTML 扩展，基本就能覆盖绝大多数写作场景。