341 lines
9.9 KiB
Markdown
341 lines
9.9 KiB
Markdown
# 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软件
|
||
- 将程序放到某个固定的文件夹中(后续不要改动位置！)，完全解压
|
||
|
||
|
||
|
||
- 解压之后运行关联格式
|
||
|
||
|
||
|
||
- 找到主程序，创建桌面快捷方式
|
||
|
||
|
||
|
||
- 双击桌面快捷方式，启动程序
|
||
|
||
|
||
|
||
### 2.3 建议配置
|
||
|
||
- 开启自动保存
|
||
|
||
|
||
|
||
- 设置图片保存的位置
|
||
|
||
|
||
|
||
- md语法的一些设置
|
||
|
||
|
||
|
||
- 窗口样式，推荐一体化
|
||
|
||
|
||
|
||
- 彻底配置完成后，关掉重开，生效设置，下面是几个功能
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 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
|
||
*斜体文本*
|
||
_斜体文本_
|
||
**粗体文本**
|
||
__粗体文本__
|
||
***粗斜体文本***
|
||
___粗斜体文本___
|
||
```
|
||
|
||
- 看下面效果
|
||
|
||
|
||
|
||
#### 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
|
||
|
||
|
||
```
|
||
|
||
|
||
|
||
### 3.5 表格
|
||
|
||
Markdown 制作表格使用 **|** 来分隔不同的单元格，使用 **-** 来分隔表头和其他行。
|
||
|
||
语法格式如下：
|
||
|
||
```markdown
|
||
| 表头 | 表头 |
|
||
| ---- | ---- |
|
||
| 单元格 | 单元格 |
|
||
| 单元格 | 单元格 |
|
||
```
|
||
|
||
**我们可以设置表格的对齐方式：**
|
||
|
||
- `---:` 设置内容和标题栏居右对齐。
|
||
- `:---` 设置内容和标题栏居左对齐。
|
||
- `:---:` 设置内容和标题栏居中对齐。
|
||
|
||
实例如下：
|
||
|
||
```markdown
|
||
| 左对齐 | 右对齐 | 居中对齐 |
|
||
| :-----| ----: | :----: |
|
||
| 单元格 | 单元格 | 单元格 |
|
||
| 单元格 | 单元格 | 单元格 |
|
||
```
|
||
|
||
- 表格举例
|
||
|
||
| 功能 | 描述 | 状态 |
|
||
| ------------------------------- | -------------------- | :--------------: |
|
||
| **用户登录** | 支持邮箱和手机号登录 | ✅ |
|
||
| *密码重置* | 通过邮箱重置密码 | ⚠️ |
|
||
| `API接口` | RESTful API 设计 | ✅ |
|
||
| [文档链接](https://example.com) | 查看详细文档 | 📖 |
|
||
|
||
## 4. 其他的用法
|
||
|
||
其他用法查看教程：https://www.runoob.com/markdown/ |