Markdown 语法速查手册

一、标题

用 # 表示标题，几个 # 就是几级标题，# 和文字之间必须有空格。

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

⚠️ #标题（没空格）不生效。一份笔记只用一个一级标题当文章名，正文用二、三级组织。

二、文字样式

中文加粗有个坑：**重点（括号）**后面 这种写法，CommonMark 可能不认，换成 **重点（括号）** 后面（加个空格）更稳。

三、列表

- 无序项
- 无序项
  - 嵌套用两个空格缩进

1. 有序项
2. 有序项
   1. 嵌套有序

• 无序列表符号：-、*、+ 都行，同一篇里统一用一个。
• 有序列表会自动编号，写 1. 全一样也能自动排。
• 列表里放多行内容：续行要缩进 4 个空格或 1 个 Tab。

- 第一行
  这是同一个列表项的续行
- 第二项

四、代码

行内代码：用一对反引号包住短命令、文件名、参数。

执行 `grep -n root /etc/passwd` 查看

代码块：三个反引号 + 语言名（高亮用），首尾各一行。

```bash
sed -i 's/old/new/g' file
```

代码块里出现三个反引号时，外层用四个反引号包住。

五、链接与图片

链接：

[显示文字](https://example.com)
[跳到本文某节](#三列表)
[相对路径的文件](notes/文件管理基础.md)

图片：

![图片说明](images/topology.png)

• 本地图片建议放笔记同目录的 images/ 下，用相对路径，方便离线、方便迁移。
• 网络图片直接写 URL，但离线会挂。
• 图片可用 HTML 控制大小：<img src="a.png" width="300">。

脚注（部分编辑器支持）：

正文里有脚注[^1]

[^1]: 这是脚注内容

六、引用

> 一级引用
> > 二级引用
>
> 引用里可以放列表、代码

引用常用来写“注意”“提示”“原文摘录”，配合 emoji 更醒目。

七、表格

| 命令 | 作用 |
| :--- | :--- |
| grep | 过滤 |
| sed | 编辑 |

• 第二行是分隔线，必须有。
• 对齐：:--- 左对齐、:---: 居中、---: 右对齐。
• 单元格里想写竖线 |，用 \| 转义。

八、分割线

---

单独一行三个 -（或 ***、___），前后要空行，否则可能被当成标题下划线。

九、任务清单

- [x] 已完成
- [ ] 未完成

• 已完成
• 未完成

十、转义字符

想显示符号本身，在前面加反斜杠：

\*不是斜体\*   \# 不是标题   \[不是链接\]

反斜杠可转义：\ ` * _ {} [] () # + - . ! |。

十一、数学公式（Typora 支持）

行内：$E=mc^2$ → $E=mc^2$

块级：

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

$$ \sum_{i=1}^{n} i = \frac{n(n+1)}{2} $$

常用：\frac{a}{b} 分数、^{} 上标、_{} 下标、\sqrt{} 根号、\sum 求和。

十二、折叠块与内嵌 HTML

Typora 支持直接写 HTML，用来做折叠答案、提示框：

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

这里是答案，可以放代码、表格。

</details>

点击展开答案

这里是答案，可以放代码、表格。

折叠块里的 Markdown 要前后空一行才会被解析。

十三、笔记模板（直接照抄）

# 主题名称

> 一句话总结：……
> 适用：……

## 一、核心概念
### 1.1 是什么
### 1.2 为什么需要它

## 二、关键知识点

## 三、动手实验

## 速查表

## 常见坑

## 练习（10 题）

## 答案与解析

固定结构的好处：复习时知道去哪找，生成 HTML 时也能自动识别「速查表」和「练习」。

十四、常用图标与符号

图标别滥用，一节一两个就够；纯文本环境（如终端）里可能显示成方块。

十五、写作规范建议

1. 一篇一个主题，标题写清楚，别用“笔记1”。
2. 结构统一：总结 → 概念 → 命令/示例 → 速查 → 练习。
3. 命令统一放代码块并标语言，方便复制和高亮。
4. 表格用于对比，别用表格写长段落。
5. 中英文之间加空格（使用 grep 命令），可读性更好。
6. 专有名词首次出现给英文（子网掩码（subnet mask））。
7. 每篇末尾放「一句话总结」，复习时只看它。

十六、编辑器与快捷键（Typora）

速查表（最常用 10 个）

# 标题
**加粗**  *斜体*  `代码`  ~~删除~~
- 列表
1. 有序列表
> 引用
[链接](url)
![图片](path)
| 表头 | 表头 |
| --- | --- |
代码块：三个反引号 + 语言
---

### 三级标题

***非常重要***

![网络拓扑](images/topology.png)

\*这不是斜体\*

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

答案内容

</details>