十分钟上手markdown

十分钟学会用 Markdown 记录学习笔记

Markdown 是一种轻量级标记语言，它让你能用易读易写的纯文本格式编写文档，再转换成结构化的 HTML（或PDF、Word）。对于记学习笔记来说，它非常高效：你只需要记住几个简单的符号，就能让笔记层次分明、重点突出，而且完全兼容代码块、表格等常见需求。

---

标题

用 # 表示标题，# 越多，标题级别越低。一般笔记用三级标题就够了。

# 一级标题（相当于 H1）
## 二级标题（H2）
### 三级标题（H3）
#### 四级标题（H4）…… 最多到六级

笔记技巧： 用一级标题作为笔记主题，二级标题分模块，三级标题具体知识点。

---

强调

• 加粗：用 **文字** 或 __文字__
• 斜体：用 *文字* 或 _文字_
• 加粗斜体：用 ***文字***
• 删除线：用 ~~文字~~

这是**重要概念**，这是*需要注意的地方*，这是***强调又强调***，这是~~过时内容~~。

效果： 这是重要概念，这是需要注意的地方，这是强调又强调，这是过时内容。

---

列表

无序列表

用 -、+ 或 * 开头，后面跟空格。

- 第一条笔记
- 第二条笔记
  - 嵌套子笔记（前面加两个空格）
  - 再嵌套

有序列表

用 数字. 开头。

1. 第一步操作
2. 第二步操作
   1. 子步骤（缩进两个空格）
   2. 子步骤

效果：

• 第一条笔记
• 第二条笔记
  • 嵌套子笔记

1. 第一步操作
2. 第二步操作
   1. 子步骤

---

代码与代码块

• 行内代码：用反引号 `代码` 包裹，例如 `print("hello")` 显示为 print("hello")。
• 代码块：用三个反引号包裹，并指定语言（可选）以获得语法高亮。

```python
# 这是一个 Python 代码块
def hello():
    print("Hello, Markdown!")
```

效果：

# 这是一个 Python 代码块
def hello():
    print("Hello, Markdown!")

---

链接

普通链接

[显示文本](https://网址)

例如：

[Google](https://www.google.com)

效果：Google

图片链接

![替代文本](图片地址)

例如：

![示例图片](https://img2024.cnblogs.com/blog/3710150/202603/3710150-20260310224448184-675222013.png)

效果：

---

引用

用 > 开头。

> 这是一个引用块，可以用来摘抄教材定义或提示重要信息。
> 多行引用可以连续使用 >。

效果：

这是一个引用块，可以用来摘抄教材定义或提示重要信息。
多行引用可以连续使用 >。

---

表格

用 | 分隔单元格，第二行用 - 分隔表头与内容，可用 : 控制对齐。

| 语法元素 | 作用           | 示例      |
| :------- | :------------: | --------: |
| 标题     | 组织结构       | `# H1`    |
| 粗体     | 强调           | `**粗**`  |
| 列表     | 条理化         | `- 项`    |

效果：

语法元素	作用	示例
标题	组织结构	# H1
粗体	强调	**粗**
列表	条理化	- 项

---

任务列表

用 - [ ] 表示未完成，- [x] 表示已完成。

- [x] 学完标题语法
- [ ] 练习代码块
- [ ] 整理今天的笔记

效果：

• 学完标题语法
• 练习代码块
• 整理今天的笔记

---

水平分割线

用三个或以上的 -、*、_ 单独一行。

---

---

一个完整的笔记示例

将上面的元素组合起来，就能写出一份漂亮的笔记：

# Python 基础学习笔记 2026-03-10

## 1. 变量与数据类型

- **整数**：`int`，例如 `a = 10`
- **字符串**：`str`，例如 `name = "Markdown"`

> 注意：Python 是动态类型语言，变量无需声明类型。

## 2. 条件判断

```python
age = 18
if age >= 18:
    print("成年")
else:
    print("未成年")

---