Markdown 语法完全指南 2026 | 零基础小白写作入门

Markdown 语法完全指南

写笔记、发博客、写文档……你还在用 Word 吗？那你就 OUT 了！现在最流行的写作方式是 Markdown——用简单的符号就能排版，写完直接可以放到网站上。这篇教程用大白话带你从零掌握 Markdown。

一、Markdown 是什么？

1.1 通俗理解

想象你用笔写作文：

用 Word：写一句，然后选中文字点「加粗」、选「字号」、调「字体」…边写边点按钮，很费事
用 Markdown：写的时候顺手加几个符号，写完格式就自动有了

比如要写「这是加粗的文字」：

markdown

这是**加粗**的文字

就这么简单！不用任何按钮，打两个星号包起来就加粗了。

一句话总结：Markdown 是「写的时候顺手排版」的轻量级语言。

1.2 为什么用 Markdown？

优势	说明
纯文本格式	什么编辑器都能打开，永远不会损坏
写得快	手不用离开键盘，敲符号就能排版
兼容性强	GitHub、掘金、知乎、微信公众号都支持
容易转格式	一键转 PDF、HTML、Word、电子书
专注内容	不用管样式，专心写就行

1.3 用什么写 Markdown？

你可以用这些工具（推荐从上往下选）：

工具	适合人群	说明
Typora	所有人	「所见即所得」，写完立刻看到效果，最易用
Obsidian	笔记党	双链笔记、双向链接，打造知识图谱
VS Code	程序员	左边写 Markdown，右边预览
Notion	团队协作	在线协作、数据库功能强
任何文本编辑器	极简主义	记事本也能写 Markdown！

💡 新手建议：直接用 Typora，它是目前最像 Word 的 Markdown 编辑器，你边写边看效果，零学习负担。

二、标题（大小字号）

2.1 用 # 号表示标题

想要大小标题？在文字前加 # 号就行，# 越多，字越小：

markdown

# 一级标题（最大，类似 Word 的「标题 1」）
## 二级标题（类似「标题 2」）
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题（最小）

渲染效果：

一级标题（最大）

二级标题

三级标题

四级标题

五级标题

六级标题（最小）

💡 注意事项：
# 和文字之间要有一个空格
一篇文章只用一个 #（一级标题），通常就是文章标题
层级要按顺序，不要从 # 直接跳到 ####

三、文字格式化

3.1 加粗、斜体、删除线、高亮

用一对符号把文字包起来就行：

markdown

**这是加粗的文字**
*这是斜体的文字*
***这是加粗又斜体***
~~这是删除线的文字~~
==这是高亮的文字==（部分编辑器支持）

渲染效果：

这是加粗的文字这是斜体的文字这是加粗又斜体~~这是删除线的文字~~ ==这是高亮的文字==

💡 记忆技巧：
加粗 = 两颗星 ** = 力度大
斜体 = 一颗星 * = 力度小
删除线 = 两条波浪 ~~ = 画横线划掉
加粗斜体 = 三颗星 *** = 1+2

3.2 下划线上标下标

下划线、上标、下标在部分编辑器中支持：

markdown

++下划线文字++（部分编辑器）

水的化学式：H~2~O  （下标，部分编辑器支持）
数学公式：x^2^ 表示 x 的平方（上标，部分编辑器支持）

如果编辑器不支持，可以直接用 HTML 标签（Markdown 允许嵌入 HTML）：

html

<u>下划线文字</u>
H<sub>2</sub>O
x<sup>2</sup>

3.3 分隔线

想要在两段之间画一条分隔线？连续写三个（或更多）相同符号：

markdown

---（三个短横线，最常用）
***（三个星号）
___（三个下划线）

渲染效果：

💡 推荐用三个短横线 ---，最好记。

四、列表

4.1 无序列表（小圆点/方块）

用 *、+ 或 - 加空格，任意选一种都行：

markdown

* 苹果
* 香蕉
* 橘子

- 也可以用短横线
- 项目二
- 项目三

+ 或者用加号
+ 项目 A
+ 项目 B

渲染效果：

苹果
香蕉
橘子

4.2 有序列表（123编号）

数字加英文点再加空格：

markdown

1. 打开冰箱门
2. 把大象放进去
3. 关上冰箱门

渲染效果：

打开冰箱门
把大象放进去
关上冰箱门

💡 小技巧：所有数字写 1 也行，Markdown 会自动帮你编号：
markdown
1. 第一项
1. 第二项
1. 第三项
显示出来还是 1、2、3，这样调整顺序时不用改数字！

4.3 嵌套列表

想做多级列表？按 Tab 缩进一层：

markdown

- 水果
  - 苹果
    - 红富士
    - 金帅
  - 香蕉
- 蔬菜
  - 番茄
    1. 红色番茄
    2. 黄色番茄
  - 黄瓜

渲染效果：

水果
- 苹果
  - 红富士
  - 金帅
- 香蕉
蔬菜
- 番茄
  1. 红色番茄
  2. 黄色番茄
- 黄瓜

💡 混合使用也完全没问题！

4.4 任务列表（带勾选框）

待办事项专用，像 Todo 清单：

markdown

- [x] 买牛奶
- [x] 写周报
- [ ] 锻炼身体
- [ ] 给妈妈打电话

渲染效果：

买牛奶
写周报
锻炼身体
给妈妈打电话

💡 这个功能在 GitHub、Obsidian、Notion 里特别常用，做项目管理或个人待办非常方便。

五、引用块

5.1 引用别人的话

用 > 加空格：

markdown

> 子曰：「学而时习之，不亦说乎？」

渲染效果：

子曰：「学而时习之，不亦说乎？」

5.2 多层嵌套引用

按两个 >>、三个 >>> 就能嵌套：

markdown

> 第一层引用
>
>> 第二层引用
>>
>>> 第三层引用

渲染效果：

第一层引用
第二层引用
第三层引用

5.3 引用里也能放其他格式

markdown

> # 标题也能放引用里
>
> - 列表也能放
> - **加粗**和*斜体*也行
>
> 段落没问题

六、链接和图片

6.1 超链接

语法：[显示文字](链接地址 "可选标题")

markdown

[去谷歌搜搜](https://www.google.com)

[点击看关于页面](/about)

[打开百度](https://www.baidu.com "鼠标悬停时显示的文字")

渲染效果：

去谷歌搜搜

6.2 自动链接

完整网址直接写，会自动变成可点击的链接：

markdown

我的博客：https://y-m.top

邮箱也可以：hello@example.com

6.3 图片

和链接几乎一样，只是在最前面多加一个感叹号 !：

markdown

![图片描述文字](图片地址)

![苹果公司的Logo](https://www.apple.com/favicon.ico)

![加个标题](photo.jpg "鼠标悬停时显示")

💡 图片描述文字的作用：
图片加载失败时会显示这段文字
盲人阅读器会读这段文字
搜索引擎靠这段文字识别图片内容（SEO）

6.4 图文链接

点击图片跳转到一个网页？把图片语法嵌在链接语法里：

markdown

[![图片描述](图片地址)](跳转的链接地址)

[![点击访问苹果官网](https://www.apple.com/favicon.ico)](https://www.apple.com)

七、代码

7.1 行内代码

把一小段代码嵌在文字中间，用一对反引号（键盘左上角 ~ 那个键，也叫「重音符」）：

markdown

在 JavaScript 里用 `console.log()` 来打印信息。

HTML 的标签是 `<title>标题</title>`。

渲染效果：

在 JavaScript 里用 console.log() 来打印信息。

HTML 的标签是 <title>标题</title>。

7.2 代码块（多行代码）

要写大段代码？用三个反引号包起来，开头的反引号后面可以指定编程语言，方便显示语法高亮：

```javascript
function sayHi(name) {
  console.log(`你好，${name}！`)
}
sayHi('小明')
```

渲染效果：

javascript

function sayHi(name) {
  console.log(`你好，${name}！`)
}
sayHi('小明')

💡 常用的语言标记： javascript、python、java、html、css、bash（命令行）、json、yaml、sql、go、rust、typescript、vue、jsx……

7.3 命令行示例

bash

# 安装 pnpm
npm install -g pnpm

# 初始化项目
pnpm init

# 安装依赖
pnpm install

💡 前面写 # 的是注释，代表「说明，不用执行」。

八、表格

8.1 基础表格

用竖线 | 分隔每一列，用短横线 --- 分隔表头和内容：

markdown

| 姓名 | 年龄 | 城市 |
|------|------|------|
| 小明 | 25   | 北京 |
| 小红 | 22   | 上海 |
| 小刚 | 28   | 广州 |

渲染效果：

姓名	年龄	城市
小明	25	北京
小红	22	上海
小刚	28	广州

💡 对齐方式：
:--- = 左对齐（默认）
---: = 右对齐
:---: = 居中对齐
示例：
markdown
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 苹果   |  ¥5  |  100kg |

8.2 对齐方式示例

markdown

| 商品   | 单价  |  数量 |
|:-------|:-----:|------:|
| 苹果   |  ¥5   |   100 |
| 香蕉   |  ¥3   |    50 |
| 橘子   |  ¥4   |    80 |

九、转义字符

9.1 想显示符号本身怎么办？

如果写了一个星号但不想让它变斜体？在符号前加反斜杠 \ 就行：

markdown

*这会是斜体*

\*这不会是斜体\*

\# 井号也能正常显示

渲染效果：

这会是斜体

*这不会是斜体*

9.2 所有可以转义的符号

markdown

\*   星号
\_   下划线
\+   加号
\-   减号
\.   句号
\!   感叹号
\#   井号
\|   竖线
\`   反引号
\[   方括号
\(   圆括号

十、实用扩展语法

不同编辑器支持不同的扩展功能，下面是几个最常用的：

10.1 脚注

markdown

这是一段文字[^1]，后面有脚注。

[^1]: 这里是脚注的详细内容，一般会显示在页面底部。

10.2 目录（自动生成）

markdown

@[TOC](目录)

（或者单独写：）
[TOC]

很多编辑器（Typora、VS Code 插件）支持这个语法，会自动根据文章的标题生成一个可点击的目录。

10.3 提示框（Callout）

Obsidian 和一些静态网站生成器（VitePress 等）支持：

markdown

> [!NOTE]
> 这是一个提示信息。

> [!TIP]
> 这是一个技巧提示。

> [!WARNING]
> 这是一个警告！

> [!DANGER]
> 这是危险操作！

10.4 Mermaid 流程图

现代编辑器都支持用 Mermaid 语法直接画图，不用装任何画图软件：

```mermaid
graph TD
  A[起床] --> B[洗漱]
  B --> C[吃早饭]
  C --> D{今天上班吗？}
  D -->|是| E[出门上班]
  D -->|否| F[在家休息]
```

渲染效果：

mermaid

graph TD
  A[起床] --> B[洗漱]
  B --> C[吃早饭]
  C --> D{今天上班吗？}
  D -->|是| E[出门上班]
  D -->|否| F[在家休息]

💡 Mermaid 还能画时序图、饼图、甘特图、状态机……非常强大！

十一、Markdown 写作技巧

11.1 段落和换行

Markdown 里，行末按两个空格再回车才会换行，否则两行会合并成一段：

markdown

这是第一行。
这是第二行。（这两行会合在一起）

这是第三行。

这是第四行。（空一行就是新段落）

11.2 快捷键（打字更快）

在 Typora / Obsidian 里，熟练用快捷键能快到飞起来：

快捷键	功能
Ctrl/Cmd + B	加粗
Ctrl/Cmd + I	斜体
Ctrl/Cmd + K	插入链接
Ctrl/Cmd + Shift + K	插入代码块
Ctrl/Cmd + 1~6	一到六级标题
Ctrl/Cmd + Enter	插入表格

11.3 文件命名

Markdown 文件后缀名是 .md（推荐）或 .markdown：

好的文件名：
  2026-08-07-markdown-guide.md
  my-first-blog-post.md
  读书笔记_百年孤独.md

不要用：
  文档.md（太通用）
  新文档 2.md（不知所云）

十二、实战练习

12.1 练习一：写一篇读书笔记

markdown

# 《百年孤独》读书笔记

> 多年以后，奥雷里亚诺·布恩迪亚上校将会回想起父亲带他去见识冰块的那个遥远的下午。

## 基本信息

| 项目 | 内容 |
|------|------|
| 作者 | 加西亚·马尔克斯 |
| 体裁 | 魔幻现实主义 |
| 字数 | 约26.2万 |
| 阅读时间 | 2026.07.20 - 2026.08.01 |

## 主要人物

1. **何塞·阿尔卡蒂奥·布恩迪亚**：马孔多的创建者
2. **乌尔苏拉**：家族的支柱
3. **奥雷里亚诺上校**：发动32场武装起义
   - 每一场都失败了
   - 最后被遗忘

## 读书笔记

### 关于孤独

> 生命中真正重要的不是你遭遇了什么，而是你记住了哪些事，以及你是如何铭记的。

布恩迪亚家族的孤独来自于：

* 不懂得去爱
* 陷入重复的命运轮回
* 无法沟通与理解

### 关于魔幻现实主义

作者把现实和虚构混在一起，读的时候会觉得：
- `时间` 是循环的
- `命运` 是重复的
- `记忆` 是被遗忘的

## 好句摘抄

1. 过去都是假的，回忆是一条没有归途的路。
2. 买下一张永久车票，登上一列永不抵达的火车。
3. 生命中曾经有过的所有灿烂，终究都需要用寂寞来偿还。

## 我的评分

- [x] 故事性：⭐⭐⭐⭐⭐
- [x] 文笔：⭐⭐⭐⭐⭐
- [x] 思想深度：⭐⭐⭐⭐⭐
- [ ] 易读性：⭐⭐⭐（人名多，记起来费劲）

12.2 练习二：写一篇技术教程结构

markdown

# 从零开始学 Vue 3

## 1. 环境准备

### 1.1 安装 Node.js

去官网下载安装包：[https://nodejs.org](https://nodejs.org)

检查是否安装成功：

```bash
node -v
npm -v

1.2 创建项目

bash

npm create vue@latest
cd my-vue-app
npm install
npm run dev

2. 基本概念

Vue 的三大核心：

响应式数据：用 ref() 包起来
组件化：把页面拆成一个个小组件
组合式 API：用 Composition API 组织代码

3. 示例代码

vue

<script setup>
import { ref } from 'vue'

const count = ref(0)
const double = () => count.value * 2
</script>

<template>
  <h1>计数器</h1>
  <p>当前数值：{{ count }}</p>
  <p>双倍数值：{{ double() }}</p>
  <button @click="count++">加 1</button>
</template>

4. 推荐阅读

资源	说明
Vue 官方文档	最权威
Vue 3 Composition API 最佳实践	本网站教程
Vite 完全指南	构建工具教程


---

## 十三、常见问题

### 13.1 Markdown 和 Word 哪个好？

| 场景 | 推荐 |
|------|------|
| 写代码/技术文档/博客/笔记 | **Markdown** ✅ |
| 写合同/简历/正式公文/需要大量排版 | Word ✅ |

### 13.2 微信公众号支持 Markdown 吗？

原生不支持，但可以用这些工具转：

- **Markdown Nice**：在线转公众号排版
- **墨滴**：Markdown 转公众号
- **Typora**：复制粘贴到公众号

### 13.3 写 Markdown 时，图片放哪里？

几个方案：

1. **本地文件夹**：`./images/photo.jpg`（本地笔记）
2. **GitHub 仓库**：免费，可公开访问（本网站用的就是这个）
3. **图床**：SM.MS、PicList + GitHub 等（免费，适合博客）
4. **Obsidian 附件**：自动存本地文件夹

---

## 十四、Markdown 速查表

### 14.1 常用语法速查

| 语法 | 效果 | 代码 |
|------|------|------|
| **加粗** | 加粗 | `**加粗**` |
| *斜体* | 斜体 | `*斜体*` |
| ~~删除线~~ | 删除线 | `~~删除线~~` |
| `代码` | 代码 | `` `代码` `` |
| [链接](url) | 链接 | `[文字](url)` |
| ![图](url) | 图片 | `![描述](url)` |
| > 引用 | 引用块 | `> 引用文字` |
| 无序列表 | - 项目 | `- 项目` |
| 有序列表 | 1. 项目 | `1. 项目` |
| 任务列表 | - [x] 已完成 | `- [x] 任务` |

### 14.2 快捷键速查（Typora）

| 功能 | 快捷键 |
|------|--------|
| 加粗 | Ctrl/Cmd + B |
| 斜体 | Ctrl/Cmd + I |
| 标题1~6 | Ctrl/Cmd + 1~6 |
| 链接 | Ctrl/Cmd + K |
| 图片 | Ctrl/Cmd + Shift + I |
| 代码块 | Ctrl/Cmd + Shift + K |
| 表格 | Ctrl/Cmd + T |
| 引用 | Ctrl/Cmd + Shift + Q |
| 查找替换 | Ctrl/Cmd + F / H |

---

## 十五、总结

回顾本教程的要点：

1. **标题**：用 `#` 号，1 个最大，6 个最小
2. **加粗**：两颗星 `**`，斜体一颗星 `*`
3. **删除线**：两个波浪 `~~`
4. **列表**：`-` 无序，`1.` 有序，`[ ]` 任务清单
5. **引用**：用 `>` 号，`>>` 嵌套
6. **链接**：`[文字](地址)`，图片前面加个 `!`
7. **代码**：一对反引号行内，三对反引号代码块
8. **表格**：`|` 分隔列，`---` 分隔表头，对齐用 `:`
9. **换行**：行末两个空格，新段落空一行
10. **转义**：符号前加反斜杠 `\`

Markdown 就是这么简单！今天起，把你的笔记、博客、文档都换成 Markdown 吧，你会发现写作从未如此轻松。

---

**相关阅读：**
- [VS Code 使用技巧](/notes/vscode)
- [Obsidian + Git + VitePress 知识管理工作流](/notes/knowledge-management-workflow)
- [PicGo/PicList + GitHub 图床搭建教程](/notes/build-picture-bed)
- [HTML5 基础入门教程](/fe/html/html5-beginner-guide)
- [JavaScript 基础入门教程](/fe/javascript/javascript-beginner-guide)

Markdown 语法完全指南 2026 | 零基础小白写作入门 ​

一、Markdown 是什么？ ​

1.1 通俗理解 ​

1.2 为什么用 Markdown？ ​

1.3 用什么写 Markdown？ ​

二、标题（大小字号） ​

2.1 用 # 号表示标题 ​

一级标题（最大） ​

二级标题 ​

三级标题 ​

四级标题 ​

五级标题 ​

六级标题（最小） ​

三、文字格式化 ​

3.1 加粗、斜体、删除线、高亮 ​

3.2 下划线上标下标 ​

3.3 分隔线 ​

四、列表 ​

4.1 无序列表（小圆点/方块） ​

4.2 有序列表（123编号） ​

4.3 嵌套列表 ​

4.4 任务列表（带勾选框） ​

五、引用块 ​

5.1 引用别人的话 ​

5.2 多层嵌套引用 ​

5.3 引用里也能放其他格式 ​

六、链接和图片 ​

6.1 超链接 ​

6.2 自动链接 ​

6.3 图片 ​

6.4 图文链接 ​

七、代码 ​

7.1 行内代码 ​

7.2 代码块（多行代码） ​

7.3 命令行示例 ​

八、表格 ​

8.1 基础表格 ​

8.2 对齐方式示例 ​

九、转义字符 ​

9.1 想显示符号本身怎么办？ ​

9.2 所有可以转义的符号 ​

十、实用扩展语法 ​

10.1 脚注 ​

10.2 目录（自动生成） ​

10.3 提示框（Callout） ​

10.4 Mermaid 流程图 ​

十一、Markdown 写作技巧 ​

11.1 段落和换行 ​

11.2 快捷键（打字更快） ​

11.3 文件命名 ​

十二、实战练习 ​

12.1 练习一：写一篇读书笔记 ​

12.2 练习二：写一篇技术教程结构 ​

1.2 创建项目 ​

2. 基本概念 ​

3. 示例代码 ​

4. 推荐阅读 ​

Markdown 语法完全指南 2026 | 零基础小白写作入门

一、Markdown 是什么？

1.1 通俗理解

1.2 为什么用 Markdown？

1.3 用什么写 Markdown？

二、标题（大小字号）

2.1 用 # 号表示标题

一级标题（最大）

二级标题

三级标题

四级标题

五级标题

六级标题（最小）

三、文字格式化

3.1 加粗、斜体、删除线、高亮

3.2 下划线上标下标

3.3 分隔线

四、列表

4.1 无序列表（小圆点/方块）

4.2 有序列表（123编号）

4.3 嵌套列表

4.4 任务列表（带勾选框）

五、引用块

5.1 引用别人的话

5.2 多层嵌套引用

5.3 引用里也能放其他格式

六、链接和图片

6.1 超链接

6.2 自动链接

6.3 图片

6.4 图文链接

七、代码

7.1 行内代码

7.2 代码块（多行代码）

7.3 命令行示例

八、表格

8.1 基础表格

8.2 对齐方式示例

九、转义字符

9.1 想显示符号本身怎么办？

9.2 所有可以转义的符号

十、实用扩展语法

10.1 脚注

10.2 目录（自动生成）

10.3 提示框（Callout）

10.4 Mermaid 流程图

十一、Markdown 写作技巧

11.1 段落和换行

11.2 快捷键（打字更快）

11.3 文件命名

十二、实战练习

12.1 练习一：写一篇读书笔记

12.2 练习二：写一篇技术教程结构

1.2 创建项目

2. 基本概念

3. 示例代码

4. 推荐阅读