Markdown 入门教程:用最简单的符号写出漂亮的文章

如果你写过博客、记过笔记,大概都听过 Markdown 这个名字。它不是什么高深的技术,而是一种轻量级标记语言——用几个简单的符号,就能完成排版,不用鼠标点来点去,纯文本写完自动渲染成漂亮格式。

为什么选择Markdown?

  • 极简:记住十来个符号就能上手,几乎零学习成本

  • 通用:GitHub、CSDN、语雀、Obsidian 全都支持,一份稿子到处用

  • 专注:不用纠结格式的排版,专心写内容

  • 纯文本:天然适配版本管理,方便对比和协作

核心语法预览

1. 标题

Markdown中使用# 作为标题的提示符,# 越多表示标题级别越低,一共有六个等级:

# 我是一级标题
## 我是二级标题
### 我是三级标题

注意:# 后面要加空格,不然不会被识别为标题

要善于运用标题,逻辑层级清晰且美观。

2. 文本样式

**加粗**

*斜体*

~~删除线~~

`行内代码`

<u>下划线</u>

使用**包裹是加粗

使用*包裹是斜体

使用~~包裹是删除线

使用`包裹显示行内代码

当然,Markdown也是支持HTML语法的

如下划线的表示可以用<u></u>标签包裹:下划线

当然,也可以嵌套使用

***加粗斜体***

*~~斜体删除~~*

<u>下划线</u>

<font color="red">曾经沧海难为水,除却巫山不是云。</font>  <!-- 红色的文本 -->

加粗斜体

斜体删除

下划线

曾经沧海难为水,除却巫山不是云。

3. 列表

列表可分为有序表格和无序表格

有序表格顾名思义就是有数字排序的表格,用数字加点来表示:

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

效果:

  1. 第一行

  2. 第二行

  3. 第三行


无序表格可以用-加空格来表示:

- 吃饭
- 睡觉
- 打豆豆

效果:

  • 吃饭

  • 睡觉

  • 打豆豆


4. 引用

在Markdown中可以使用> 表示引用:

> 这是一段引用文本
> 
> 来表达我对你的喜欢

效果:

这是一段引用文本
来表达我对你的喜欢

5. 代码块

使用三个反引号` 包裹,后跟上语言的名称支持语法高亮:

```python
# 一个计算时间的小工具
from datetime import datetime

meet = datetime(2026, 10, 2)
now = datetime.now()
days = (now - meet).days

print(f"和你相识之后,已经多了 {days} 个值得记录的日子") # 答案会是多少呢
```

效果:

# 一个记录时间的小工具
from datetime import datetime

meet = datetime(2026, 10, 2)
now = datetime.now()
days = (now - meet).days

print(f"和你相识之后,已经多了 {days} 个值得记录的日子") # 答案会是多少呢

6. 超链接和图片

超链接的写法是:[这里是你想要显示的文字](这里是点击后会跳转的链接)

图片显示的写法是:![鼠标移动到图片上面的描述](图片的地址,可以是file:///的本地图片和图片网址)

[百度一下,你就知道](https://www.baidu.com/)

![一张图片](https://lsky.lolxf.com/ha/2026/10/10/6ac9989305b04.png)

效果:

一张图片

7. 表格

Markdown的表格真是超爱,既简单又美观:

|姓名|年龄|职业|
|---|---|---|
|张三|24|前端工程师|
|李四|25|后端工程师|

这里第一行是表头,第二行需要至少三个- 来分离表头和其他行。

效果:

姓名 年龄 职业
张三 24 前端工程师
李四 25 后端工程师

第二行这里是可以加: 来设置表格的对齐方式的,冒号在左边意为左对齐,在右边意为右对齐,左右各有一个冒号就是居中对齐

|姓名|年龄|职业|
|:---|:---:|---:|
|张三|24|前端工程师|
|李四|25|后端工程师|

这样的效果就是姓名这一列是左对齐,年龄是居中对齐,而职业是右对齐:

姓名 年龄 职业
张三 24 前端工程师
李四 25 后端工程师

8. 任务清单

使用- [ ] 表示未打勾的代办,方括号中间加上一个X 即可显示打勾状态

- [X] 吃饭
- [X] 睡觉
- [X] 想你
- [ ] 打豆豆

效果:

  • 吃饭
  • 睡觉
  • 想你
  • 打豆豆

9. 分割线

使用--- *** ___ 均可,最少是三个字符,当然更多也可以:

---
减号分割线
***
星号分割线
___
下划线分割线

他们的效果是相同的:


减号分割线


星号分割线


下划线分割线

新手常见错误

  • # 后面不加空格,不会变成标题

  • 列表符号后面不加空格,格式会变乱

  • 代码块的语言要写准,不然没有高亮代码

  • 段落之间是要空一行的,不然无法被识别为下一行

推荐使用的编辑器

  • Typora:所见即所得,颜值高,语法适配多,这个真是强推荐,有实力的同学可以支持正版

  • VS Code:程序员首选编辑器,丰富的插件库,备受众多程序员青睐

结语

Markdown 就是最简单、最通用、不用鼠标排版的写作语言。记住这几个符号——# 标题、*斜体、 **加粗、-列表、`行内代码、|表格,你就已经掌握了 99% 的用法。

写博客、做笔记、写文档都可以用上Markdown,干净、高级、省时省力。