# Markdown

## 1. 为什么不用word或者纸笔？

### 1.1 记笔记的目的

> 你是为今天记笔记，还是为未来建立知识库？

很多同学记笔记只是为了**应付考试**，
 但学 IT 的笔记，应该是为了**长期积累、复盘、提升自我效率**。

Markdown 就是帮助你做到这一点的工具。

### 1.2 记录“代码与操作过程”

| 比较项   | 纸笔笔记                 | Markdown 笔记                           |
| -------- | ------------------------ | --------------------------------------- |
| 记录代码 | ❌ 手抄代码既慢又容易写错 | ✅ ```python print("Hello") ``` 一行搞定 |
| 记录截图 | ❌ 手绘图太耗时           | ✅ Typora 直接拖入截图                   |
| 搜索复用 | ❌ 翻笔记很慢             | ✅ Ctrl+F 秒搜到关键字                   |
| 更新修改 | ❌ 涂改麻烦               | ✅ 随时编辑、版本管理                    |
| 云同步   | ❌ 无法共享               | ✅ 可推送至 Gitee/GitHub                 |

📌 **结论**：纸笔适合做思维草稿，而不适合整理和保存技术内容。

### 1.3 word的问题

Word 很强大，但不适合技术笔记的原因主要有五个：

#### 1️⃣ 文件臃肿 & 格式混乱

- 每次复制代码，格式都会错乱。
- Tab、空格、缩进会被破坏。
- 导出和跨设备阅读都很麻烦。

#### 2️⃣ 不利于版本管理

- 改一处就得重新保存一份 `.docx`。
- 没法查看“上一个版本改了什么”。
- Git 对二进制文件（如 Word）无法对比差异。

#### 3️⃣ 不适合代码展示

- 代码块没有语法高亮。
- 排版与复制体验差。
- 无法在命令行或项目文档中直接使用。

#### 4️⃣ 不通用

- Word 文件只能在有 Office 的地方打开。
- 而 Markdown 是纯文本，任何系统都能打开。

#### 5️⃣ 不专业

- 技术行业中，项目文档、README、开发手册，几乎全部使用 Markdown。
   👉 用 Word 写项目笔记，会显得“像没入门”。

### 1.4 md技术人的语言

#### ✅ Markdown 的核心价值

1. **轻量化** —— 不需要格式菜单，专注内容
2. **可复用** —— 一份笔记能在网页、PDF、GitHub 都通用
3. **结构化** —— 用 `#`、`-`、代码块清晰展示知识层次
4. **自动化** —— 可与工具（如 Typora、Obsidian、Gitee）结合
5. **版本化** —— 与 Git 完美结合，记录学习历程

### 1.5 md的延展能力

学习 Markdown，不只是为了“写漂亮的笔记”，  
而是在为未来的学习与工作打基础。

| 未来场景     | Markdown 的用法                    |
| ------------ | ---------------------------------- |
| 📘 写项目文档 | README.md                          |
| 🧑‍💻 写博客    | 用 Hexo、Hugo、VuePress 等生成网站 |
| 📂 整理知识库 | Obsidian / Typora 笔记体系         |
| 🧠 团队协作   | Git + Markdown 共享文档            |
| 📤 面试准备   | 整理问题集与项目笔记上传 Gitee     |

- 会写 Markdown，就能在技术世界里‘无障碍沟通’。

> “纸笔是用来记忆的，  
> Word 是用来排版的，  
> 而 Markdown，是用来成长的。”

## 2. Typora

### 2.1 Typora介绍

✅ Typora 的核心理念：

> “让 Markdown 写起来像 Word，用起来像程序员。”

| 优点                 | 说明                             | 举例                           |
| -------------------- | -------------------------------- | ------------------------------ |
| 🧭 **所见即所得**     | 不需要预览模式，输入即显示排版   | 输入 `#` 立即变标题            |
| 💾 **自动保存与恢复** | 防止误关丢失笔记                 | 写完不用 Ctrl+S                |
| 📸 **图片拖拽支持**   | 拖图片自动插入并复制到本地文件夹 | 适合截图讲解编程步骤           |
| 💻 **代码高亮**       | 支持上百种编程语言               | ```python print() ``` 自动高亮 |
| 📂 **导出多格式**     | 一键导出 PDF、HTML、Word         | 提交作业或打印非常方便         |
| ☁️ **跨平台同步**     | 可与 Git、Gitee、云盘结合        | Typora + Git = 学习档案库      |

📌 对于 IT 专业学生，Typora 是最理想的入门工具，因为：

- 它的学习曲线平滑；
- 不需要配置环境；
- 兼容所有 Markdown 文件（未来迁移到 Obsidian、VitePress、GitHub 都可无缝衔接）。

### 2.2 Typora安装

- 下载“特别版”Typora软件
- 将程序放到某个固定的文件夹中(后续不要改动位置！)，完全解压

![image-20251106142454358](01.Markdown/image-20251106142454358.png)

- 解压之后运行关联格式

![image-20251106142933376](01.Markdown/image-20251106142933376.png)

- 找到主程序，创建桌面快捷方式

![image-20251106143420044](01.Markdown/image-20251106143420044.png)

- 双击桌面快捷方式，启动程序

![image-20251106145620438](01.Markdown/image-20251106145620438.png)

### 2.3 建议配置

- 开启自动保存

![image-20251106150108542](01.Markdown/image-20251106150108542.png)

- 设置图片保存的位置

![image-20251106150208702](01.Markdown/image-20251106150208702.png)

- md语法的一些设置

![image-20251106150248481](01.Markdown/image-20251106150248481.png)

- 窗口样式，推荐一体化

![image-20251106150318542](01.Markdown/image-20251106150318542.png)

- 彻底配置完成后，关掉重开，生效设置，下面是几个功能

![image-20251106150448512](01.Markdown/image-20251106150448512.png)

![image-20251106150541000](01.Markdown/image-20251106150541000.png)

![image-20251106150611370](01.Markdown/image-20251106150611370.png)

## 3. Markdown语法

- md文件的格式都是 `.md` 结尾的，新建一个md文件，就可以开始练习md语法了

### 3.1 标题

Markdown 使用 `#` 号来创建标题，这是从 HTML 的 `<h1>` 到 `<h6>` 标签概念演化而来的。

使用 **#** 号可表示 1-6 级标题，一级标题对应一个 **#** 号，二级标题对应两个 **#** 号，以此类推。

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

### 3.2 文本

Markdown 段落没有特殊的格式，直接编写文字就好，**段落的换行是使用两个以上空格加上回车**。

#### 3.2.1 加粗

使用两个星号 ***\*** 或两个下划线 **__** 包围文字：

```markdown
这是**粗体文字**使用星号
这是__粗体文字__使用下划线
```

#### 3.2.2 斜体

使用一个星号 ***** 或一个下划线 **_** 包围文字：

```markdown
这是*斜体文字*使用星号
这是_斜体文字_使用下划线
```

#### 3.2.3 加粗斜体

使用三个星号 ***\**** 或三个下划线 **___**：

```markdown
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___
```

- 看下面效果

![img](01.Markdown/md3.gif)

#### 3.2.4 分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

```markdown
***

* * *

*****

- - -

----------
```

#### 3.2.5 删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 **~~** 即可，实例如下：

```markdown
~~不是~~
```

#### 3.2.6 下划线

<u>下划线</u>可以通过 HTML 的 `<u>` 标签来实现：

```markdown
<u>下划线</u>
```

#### 3.2.7 引用块

> 引用块用于突出显示重要信息、引用他人观点或创建视觉层次。
>
> Markdown 区块引用是在段落开头使用 **>** 符号 ，然后后面紧跟一个**空格**符号：

```markdown
> 区块应用
> 突出重点
```

#### 3.2.8 高亮

文本 ==高亮== 不是标准 Markdown 语法，但许多扩展支持：

```markdown
这是==高亮文本==
```

#### 3.2.9 行内代码标记

使用一个反引号 **`** 包围代码：

```markdown
使用 `git commit` 命令提交代码
变量 `userName` 存储用户名
在终端中输入 `npm install` 安装依赖
```

在一行中，如果出现代码，建议使用行内代码标记，比如：`ipconfig /all` 这样的命令

### 3.3 超链接

链接是使 Markdown 文档具有交互性的关键元素。

掌握链接语法能让你创建内容丰富、易于导航的文档。

链接使用方法如下：

```markdown
[链接名称](链接地址)
[链接文字](链接地址 "可选的标题")
```

[点我跳转到百度](https://www.baidu.com/)

### 3.4 插入图片

Markdown 图片语法格式如下：

```markdown
![替代文字](图片路径)
![替代文字](图片路径 "图片标题")
```

![MD图标](01.Markdown/image-20251106154347528.png)

### 3.5 表格

Markdown 制作表格使用 **|** 来分隔不同的单元格，使用 **-** 来分隔表头和其他行。

语法格式如下：

```markdown
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |
```

**我们可以设置表格的对齐方式：**

- `---:` 设置内容和标题栏居右对齐。
- `:---`  设置内容和标题栏居左对齐。
- `:---:` 设置内容和标题栏居中对齐。

实例如下：

```markdown
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
```

- 表格举例

| 功能                            | 描述                 |       状态       |
| ------------------------------- | -------------------- | :--------------: |
| **用户登录**                    | 支持邮箱和手机号登录 |     &#x2705;     |
| *密码重置*                      | 通过邮箱重置密码     | &#x26a0;&#xfe0f; |
| `API接口`                       | RESTful API 设计     |     &#x2705;     |
| [文档链接](https://example.com) | 查看详细文档         |    &#x1f4d6;     |

## 4. 其他的用法

其他用法查看教程：https://www.runoob.com/markdown/