Markdown 新手入门使用教程

Markdown 是一种「轻量级标记语言」,语法简单、易上手,无需复杂排版操作,就能快速写出结构清晰、美观的文本(如笔记、文档、文章、README等),目前被广泛应用于各大平台(GitHub、Notion、微信公众号、知乎等)。

核心优势:

  1. 语法极简,记住几个常用标记就能熟练使用;

  2. 跨平台兼容,写完的文本可直接在多个平台渲染显示;

  3. 专注内容创作,不用分心调整格式,自动排版整齐。

本教程聚焦「最常用语法」,覆盖日常使用99%的场景,新手跟着练,5分钟就能上手。

一、基础排版(必学)

1. 标题(层级清晰)

用「#」加空格开头,# 数量越多,标题层级越低(1-6级标题,日常1-3级足够用)。


# 一级标题(最大,常用作文档标题)

## 二级标题(常用作章节标题)

### 三级标题(常用作小节标题)

#### 四级标题

##### 五级标题

###### 六级标题(最小)

2. 段落与换行


这是第一段文本,直接输入即可。

这是第二段文本,和第一段之间空一行。

这是同一段落的换行,末尾加两个空格  (这里有两个空格)

换行后的内容。

3. 字体样式(加粗、斜体、删除线)

三种常用样式,可单独使用,也可组合使用(如加粗+斜体)。


*斜体文本* (前后各1个星号)

**加粗文本** (前后各2个星号,最常用)

***加粗斜体文本*** (前后各3个星号)

~~删除线文本~~ (前后各2个波浪线)

渲染效果:

斜体文本

加粗文本

加粗斜体文本

删除线文本

二、列表排版(常用)

分为「无序列表」和「有序列表」,适合整理要点、步骤,结构更清晰。

1. 无序列表(无需排序)

用星号,加号,减号,任选一个,加空格开头(三种符号效果一致,推荐用 * ,更简洁)。


* 要点一

* 要点二

* 要点三

  * 子要点一(前面加1个Tab,或2个空格)

  * 子要点二

2. 有序列表(需要排序)

用「数字 + . + 空格」开头,序号会自动递增(无需手动修改序号)。


1. 第一步:打开Markdown编辑器

2. 第二步:输入文本内容

3. 第三步:使用语法排版

 1. 子步骤1(前面加Tab/空格)

   2. 子步骤2

三、引用与分割线(增强可读性)

1. 引用(引用他人话语、备注)

用「>」加空格开头,可嵌套多层引用(多一个 > 就是一层)。


> 这是一级引用(常用)

> > 这是二级引用(嵌套)

> 引用结束后,直接空一行写正常文本即可。

渲染效果:

这是一级引用(常用)

这是二级引用(嵌套)

2. 分割线(分隔内容)

用「3个及以上的 * 、- 、_」,单独一行输入(推荐用 *** ,简洁不杂乱),前后空一行更美观。


这是上方内容

***

这是下方内容(分割线隔开)

四、链接与图片(高频使用)

两种语法结构相似,核心区别:图片多了一个「!」。

1. 链接(跳转至网页、文档)

语法:「[链接显示文本](链接地址 "可选备注,鼠标悬浮显示")」

[百度一下](https://www.baidu.com "点击跳转百度")

[我的笔记](https://xxx.com/note) (无备注版本)

渲染效果:百度一下(点击即可跳转)

2. 图片(插入本地/网络图片)

语法:「![图片加载失败时显示的文本](图片地址 "可选备注")」

# 网络图片(推荐,跨平台可用)

![风景图](https://xxx.com/fengjing.jpg "一张好看的风景图")

# 本地图片(仅本地编辑器可用,如Typora)

![头像](./images/touxiang.jpg) (./表示当前文件夹,images是存放图片的文件夹)

注意:网络图片需使用「可访问的图片链接」(直接右键图片复制地址即可);本地图片需保证图片路径正确,否则无法显示。

五、代码块与行内代码(程序员必备)

用于展示代码,避免格式错乱,分为「行内代码」和「代码块」。

1. 行内代码(嵌入文本中)

用「`」(反引号,键盘Tab键上方、数字1左边)将代码包裹,前后各1个。


使用 `print()` 函数可以输出内容,`name = "Markdown"` 是定义变量。

渲染效果:使用 print() 函数可以输出内容,name = "Markdown" 是定义变量。

2. 代码块(单独展示多行代码)

用「3个反引号」开头和结尾,开头可加上「编程语言」(如python、java),实现代码高亮(不写则无高亮)。


```python

# 这是Python代码块(高亮显示)

name = "Markdown教程"

print("Hello, " + name)

for i in range(3):

    print(i)

# 六、表格(整理数据,常用)

语法:用「|」分隔列,「-」分隔表头和内容,「:」可设置对齐方式(可选),简洁易记。

```markdown

# 基础表格(无对齐)

| 姓名 | 年龄 | 职业 |

| ---- | ---- | ---- |

| 张三 | 25   | 程序员 |

| 李四 | 28   | 设计师 |

# 带对齐的表格(常用)

| 姓名 | 年龄 | 职业 |

| :--- | :---: | ---: | (:---左对齐,:---:居中,---:右对齐)

| 张三 | 25   | 程序员 |

| 李四 | 28   | 设计师 |

注意:「-」的数量至少3个,对齐符号(:)加在「-」的两侧,表头和内容的「|」要对齐(不对齐也能渲染,但不美观)。

七、进阶技巧(可选,提升效率)

1. 脚注(添加备注,不影响正文)

语法:正文写「[^脚注标识]」,文末写「[^脚注标识]: 脚注内容」(标识可自定义,如1、a等)。


Markdown 非常简单[^1],适合新手快速上手[^2]。

[^1]: 语法极简,无需复杂操作

[^2]: 5分钟就能掌握常用语法

2. 任务列表(待办/已办,适合整理计划)

语法:用「- [ ]」表示待办,「- [x]」表示已办(注意空格:- 和 [ 之间、[ 和 ] 之间各1个空格)。


- [x] 学习Markdown基础语法

- [x] 练习列表和表格

- [ ] 练习代码块

- [ ] 完成一篇Markdown笔记

八、新手注意事项(避坑指南)

  1. 所有语法的「符号」和「文本」之间,必须加「1个空格」(如 # 标题、* 列表,否则无法正常渲染);

  2. 反引号(`)是代码块/行内代码的专用符号,不要和单引号(')混淆;

  3. 不同平台的Markdown渲染略有差异(如表格对齐、脚注),但核心语法一致;

  4. 新手无需记所有语法,先掌握「标题、加粗、列表、链接、图片」,够用80%场景,后续逐步补充。

九、推荐编辑器(新手友好)

本站的markdown在线编辑器即可。markdown编辑器

最后:Markdown的核心是「简化排版,专注内容」,多练2-3次,就能熟练运用,赶紧动手写一篇试试吧!🎉