一、什么是 Markdown？#

Markdown 是一种轻量级标记语言，用简单的符号来控制文字的排版格式。它的核心特点是：易读、易写、易转换。

相比 Word 这类所见即所得的编辑器，Markdown 更像是一种“用纯文本写作”的方式。你只需要在文字前后加上一些简单符号，就可以表示标题、加粗、列表、引用、代码块、表格等内容。

Markdown 常用于：

写技术文档
写博客文章
写学习笔记
写 README 文件
写论文草稿
写项目说明
写日常知识总结

尤其在 GitHub、Typora、Obsidian、Notion、VS Code、ChatGPT 等工具中，Markdown 都非常常见。

二、Markdown 的优点#

1. 简洁#

Markdown 不需要复杂的菜单操作。比如，要写一个一级标题，只需要：

1
# 这是一级标题

要加粗一段文字，只需要：

1
**这是加粗文字**

这种写法非常直接，学习成本很低。

2. 纯文本，兼容性强#

Markdown 文件通常以 .md 作为后缀，本质上是纯文本文件。

这意味着它可以被几乎所有文本编辑器打开，例如：

记事本
VS Code
Neovim
Typora
Obsidian
GitHub
各类博客平台

即使没有专门的软件，也不会影响阅读。

3. 适合长期保存#

Word 文档可能会因为版本、软件兼容性等问题出现格式错乱，而 Markdown 由于是纯文本，长期保存更加稳定。

对于学习笔记、知识库、项目文档来说，Markdown 是非常适合的格式。

4. 方便转换#

Markdown 可以转换为多种格式，例如：

HTML 网页
PDF 文档
Word 文档
幻灯片
电子书

这也是很多技术写作者、研究者和程序员喜欢使用 Markdown 的原因。

三、Markdown 的基本语法#

1. 标题#

Markdown 使用 # 表示标题。

1
# 一级标题
2
## 二级标题
3
### 三级标题
4
#### 四级标题
5
##### 五级标题
6
###### 六级标题

显示效果大致如下：

一级标题#

二级标题#

三级标题#

标题层级越低，字号通常越小。

2. 段落#

Markdown 中普通文字直接书写即可。

1
这是一段普通文字。
2

3
这是另一段普通文字。

段落之间通常空一行。

3. 加粗、斜体和删除线#

1
**加粗文字**
2

3
*斜体文字*
4

5
***加粗并斜体***
6

7
~~删除线文字~~

效果：

加粗文字

斜体文字

加粗并斜体

~~删除线文字~~

4. 列表#

无序列表#

使用 -、* 或 + 都可以。

1
- 苹果
2
- 香蕉
3
- 橘子

效果：

苹果
香蕉
橘子

有序列表#

1
1. 第一步
2
2. 第二步
3
3. 第三步

效果：

第一步
第二步
第三步

5. 引用#

引用通常用于摘录别人的话、强调某段内容，或者写说明文字。

1
> 这是一段引用文字。

效果：

这是一段引用文字。

引用也可以嵌套：

1
> 一级引用
2
>> 二级引用

6. 代码#

行内代码#

如果只想在一句话中插入一个命令、函数名或关键词，可以使用反引号。

1
使用 `ls` 命令可以查看当前目录下的文件。

效果：

使用 ls 命令可以查看当前目录下的文件。

代码块#

如果要展示多行代码，可以使用三个反引号。

1
```bash
2
cd /home
3
ls -la

1
效果：
2

3
```bash
4
cd /home
5
ls -la

代码块还可以指定语言，例如：

1
```python
2
print("Hello, Markdown!")

1
---
2

3
## 7. 链接
4

5
```markdown
6
[OpenAI 官网](https://openai.com)

效果：

OpenAI 官网

格式是：

1
[显示文字](链接地址)

8. 图片#

图片语法和链接类似，只是在前面多一个感叹号。

1
![图片说明](图片地址)

例如：

1
![Markdown Logo](https://example.com/markdown.png)

格式是：

1
![替代文字](图片链接)

其中“替代文字”用于图片无法显示时进行说明。

9. 表格#

Markdown 也可以写简单表格。

1
| 姓名 | 年龄 | 城市 |
2
|---|---:|---|
3
| 张三 | 20 | 北京 |
4
| 李四 | 22 | 上海 |
5
| 王五 | 21 | 广州 |

效果：

姓名	年龄	城市
张三	20	北京
李四	22	上海
王五	21	广州

其中：

1
:---   表示左对齐
2
---:   表示右对齐
3
:---:  表示居中对齐

10. 分割线#

使用三个或更多 -、* 或 _ 可以生成分割线。

1
---

效果：

四、Markdown 的进阶用法#

1. 任务列表#

任务列表常用于待办事项。

1
- [x] 完成 Markdown 学习
2
- [ ] 整理 Linux 笔记
3
- [ ] 写一篇博客

效果：

完成 Markdown 学习
整理 Linux 笔记
写一篇博客

2. 脚注#

有些 Markdown 编辑器支持脚注。

1
这是一个带脚注的句子。[^1]
2

3
[^1]: 这是脚注内容。

脚注常用于论文草稿、读书笔记或知识整理。

3. 数学公式#

在支持 LaTeX 的 Markdown 编辑器中，可以写数学公式。

行内公式：

1
质能方程是 $E = mc^2$。

块级公式：

1
$$
2
E = mc^2
3
$$

常见于学术写作、数学笔记和技术文档。

4. HTML 标签#

Markdown 也可以混合使用部分 HTML 标签。

1
<span style="color:red;">这是一段红色文字。</span>

不过，不同平台对 HTML 的支持程度不同，所以一般不建议过度依赖 HTML。

五、Markdown 常见使用场景#

1. 写学习笔记#

Markdown 非常适合整理知识体系，例如：

1
# Linux 学习笔记
2

3
## 常用命令
4

5
- `ls`：查看文件
6
- `cd`：切换目录
7
- `pwd`：显示当前路径

它可以让笔记结构清晰，便于长期维护。

2. 写项目 README#

在 GitHub 上，项目说明文件通常叫：

1
README.md

它一般包括：

项目简介
安装方法
使用方法
配置说明
常见问题
许可证信息

3. 写博客文章#

很多博客系统支持 Markdown，例如：

Hexo
Hugo
Jekyll
WordPress 部分编辑器
GitHub Pages

使用 Markdown 写博客，可以专注于内容本身，而不是频繁调整格式。

4. 写论文和文档草稿#

虽然最终论文可能需要 Word 或 LaTeX 格式，但 Markdown 很适合早期写作。

它可以帮助作者快速搭建文章结构：

1
# 题目
2

3
## 摘要
4

5
## 引言
6

7
## 文献综述
8

9
## 研究方法
10

11
## 研究结果
12

13
## 结论

六、常用 Markdown 编辑器#

1. Typora#

Typora 是非常流行的 Markdown 编辑器，特点是所见即所得，写作体验接近 Word，但底层仍然是 Markdown。

适合：

写文章
写笔记
写报告
导出 PDF

2. Obsidian#

Obsidian 适合构建个人知识库。它支持双向链接、标签、插件和知识图谱。

适合：

长期知识管理
读书笔记
学术笔记
个人知识库

3. VS Code#

VS Code 支持 Markdown 预览，也有大量插件。

适合：

程序员
技术文档写作
README 编写
项目笔记管理

4. Neovim / Vim#

对于喜欢键盘操作和终端环境的人来说，Neovim 也非常适合写 Markdown。

配合插件后，可以实现：

Markdown 高亮
实时预览
表格格式化
代码块编辑
文档快速跳转

七、Markdown 写作建议#

1. 标题层级要清晰#

不要随意跳级。例如，不建议这样写：

1
# 一级标题
2
### 三级标题

更推荐：

1
# 一级标题
2
## 二级标题
3
### 三级标题

这样文章结构更清楚。

2. 列表不要太长#

列表可以让内容更清晰，但如果列表过长，也会影响阅读。长列表可以拆成多个小节。

3. 代码块要注明语言#

比如写 Shell 命令时：

1
```bash
2
sudo apt update

1
写 Python 代码时：
2

3
```markdown
4
```python
5
print("hello")

1
这样编辑器可以自动进行语法高亮。
2

3
---
4

5
## 4. 表格适合简单数据，不适合复杂排版
6

7
Markdown 表格适合展示简单信息。如果表格很复杂，建议使用 Excel、Word 或专门的数据表工具。
8

9
---
10

11
## 5. 文件名尽量规范
12

13
Markdown 文件名建议使用清晰、简短的命名方式，例如：
14

15
```text
16
linux-basic-notes.md
17
markdown-guide.md
18
research-outline.md

尽量避免过多空格和特殊符号。

八、Markdown 示例文章结构#

下面是一篇简单 Markdown 文章的基本结构：

1
# 文章标题
2

3
## 一、引言
4

5
这里写文章的背景和问题。
6

7
## 二、正文内容
8

9
这里展开主要内容。
10

11
### 1. 第一个观点
12

13
具体说明第一个观点。
14

15
### 2. 第二个观点
16

17
具体说明第二个观点。
18

19
## 三、总结
20

21
这里总结全文观点。

这种结构非常适合写学习笔记、技术文章和课程总结。

九、Markdown 与 Word 的区别#

对比项	Markdown	Word
文件类型	纯文本	富文本
学习成本	较低	较低
排版能力	基础排版强，复杂排版弱	复杂排版强
版本管理	非常适合 Git	不太适合 Git
长期保存	稳定	依赖软件兼容
适合场景	笔记、博客、文档、代码说明	正式报告、论文排版、公文

简单来说：

Markdown 更适合写内容和管理知识，Word 更适合最终排版和正式提交。

十、总结#

Markdown 是一种简单、高效、优雅的写作格式。它不追求复杂排版，而是强调内容结构和文本可读性。

对于日常学习、技术记录、知识管理和项目文档来说，Markdown 是非常值得掌握的工具。它的语法简单，但使用范围很广。只要掌握标题、列表、加粗、引用、代码块、链接、图片和表格这些基础语法，就已经可以完成大多数写作任务。

Markdown 的真正价值不只是“格式简单”，而是它能帮助我们更专注于内容本身。通过清晰的标题层级、简洁的语法和稳定的纯文本格式，Markdown 让写作、整理和分享知识变得更加自然。