aaronxu/MakeNote

Fork 0

Files

AaronXu 69cd27e037 11-06-周四_16-44-51

2025-11-06 16:44:51 +08:00

9.9 KiB

Raw Blame History

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 的核心价值

轻量化 —— 不需要格式菜单，专注内容
可复用 —— 一份笔记能在网页、PDF、GitHub 都通用
结构化 —— 用 #、-、代码块清晰展示知识层次
自动化 —— 可与工具（如 Typora、Obsidian、Gitee）结合
版本化 —— 与 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 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

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

3.2 文本

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

3.2.1 加粗

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

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

3.2.2 斜体

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

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

3.2.3 加粗斜体

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

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

看下面效果

3.2.4 分隔线

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

***

* * *

*****

- - -

----------

3.2.5 删除线

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

~~不是~~

3.2.6 下划线

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

<u>下划线</u>

3.2.7 引用块

引用块用于突出显示重要信息、引用他人观点或创建视觉层次。

Markdown 区块引用是在段落开头使用 > 符号，然后后面紧跟一个空格符号：

> 区块应用
> 突出重点

3.2.8 高亮

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

这是==高亮文本==

3.2.9 行内代码标记

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

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

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

3.3 超链接

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

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

链接使用方法如下：

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

点我跳转到百度

3.4 插入图片

Markdown 图片语法格式如下：

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

3.5 表格

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

语法格式如下：

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

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

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

实例如下：

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

表格举例

功能	描述	状态
用户登录	支持邮箱和手机号登录	✅
密码重置	通过邮箱重置密码	⚠️
`API接口`	RESTful API 设计	✅
文档链接	查看详细文档	📖

4. 其他的用法

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

9.9 KiB Raw Blame History Unescape Escape