Markdown 入门与使用指南 18小时前 1 条
Markdown 入门与使用指南

Markdown(MD)语法完全使用指南 Markdown(简称 MD)是一种轻量级标记语言,使用简单的符号即可实现文本排版、标题层级、代码展示、图片插入、表格制作等功能。 Markdown 广泛应用于个人博客、技术文档、GitHub 项目说明、知识笔记以及各类内容管理系统。 本文将从基础语法到进阶

Markdown 入门与使用指南
查看完整文章 评论

Markdown(MD)语法完全使用指南

Markdown(简称 MD)是一种轻量级标记语言,使用简单的符号即可实现文本排版、标题层级、代码展示、图片插入、表格制作等功能。

Markdown 广泛应用于个人博客、技术文档、GitHub 项目说明、知识笔记以及各类内容管理系统。

本文将从基础语法到进阶用法,带你全面了解 Markdown 的常用语法。

一、标题语法

Markdown 使用 # 符号定义标题,最多支持六级标题。

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

显示效果:

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

二、文字样式

Markdown 支持多种文字格式,可以让文章重点更加突出。

语法

效果

**粗体文字**

粗体文字

*斜体文字*

斜体文字

~~删除线~~

删除线

***粗斜体***

粗斜体

行内代码

行内代码

示例:

**这是一段粗体文字**

*这是一段斜体文字*

~~这是一段删除线文字~~

***这是一段粗斜体文字***

这是一段包含 `代码片段` 的文本。

三、段落与换行

Markdown 中,连续的文字通常属于同一个段落。

如果需要另起一段,需要在两段文字之间空一行。

这是第一段文字。

这是第二段文字。

这是第三段文字。

如果需要强制换行,可以在行尾添加两个空格,或者使用 HTML 的 <br> 标签(取决于编辑器支持情况)。

第一行文字  
第二行文字

四、列表语法

Markdown 支持无序列表、有序列表以及任务清单。

1. 无序列表

使用 -、+ 或 * 创建无序列表。

- 苹果
- 香蕉
- 橘子

显示效果:

  • 苹果

  • 香蕉

  • 橘子

2. 有序列表

使用数字加英文句点创建有序列表。

1. 第一步:准备材料
2. 第二步:开始制作
3. 第三步:完成任务

显示效果:

  1. 第一步:准备材料

  2. 第二步:开始制作

  3. 第三步:完成任务

3. 嵌套列表

通过缩进可以创建多级列表。

- 前端开发
  - HTML
  - CSS
  - JavaScript
- 后端开发
  - Java
  - Python

4. 任务清单

使用 [ ] 和 [x] 创建待办事项。

- [x] 完成网站首页
- [x] 完成文章排版
- [ ] 优化移动端适配
- [ ] 发布正式版本

显示效果:

  • 完成网站首页

  • 完成文章排版

  • 优化移动端适配

  • 发布正式版本

五、引用语法

使用 > 符号可以创建引用内容,常用于名言、提示、文章摘要等场景。

> 生活不是等待风暴过去,而是学会在雨中跳舞。

显示效果:

生活不是等待风暴过去,而是学会在雨中跳舞。

也可以使用多级引用:

> 一级引用
>
> > 二级引用
> >
> > > 三级引用

六、代码块语法

Markdown 支持行内代码和多行代码块。

1. 行内代码

使用一对反引号包裹代码。

这是一个 `console.log()` 示例。

2. 多行代码块

使用三个反引号包裹代码,并可以指定代码语言。

```javascript
function hello() {
    console.log("Hello Markdown!");
}
```

显示效果:

function hello() {
    console.log("Hello Markdown!");
}

常见代码语言:

语言

标识符

HTML

html

CSS

css

JavaScript

javascript

TypeScript

typescript

Vue

vue

Python

python

Java

java

JSON

json

Shell

bash

SQL

sql

七、链接语法

使用以下格式创建超链接:

[链接名称](链接地址)

示例:

[访问百度](https://www.baidu.com)

[访问 GitHub](https://github.com)

显示效果:

如果希望鼠标悬停时显示提示文字,可以使用:

[访问 GitHub](https://github.com "全球知名代码托管平台")

八、图片插入

Markdown 使用以下语法插入图片:

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

示例:

![示例图片](https://example.com/image.png)

其中:

  • !:表示插入图片。

  • 图片描述:图片无法加载时显示的替代文字。

  • 图片地址:图片的网络地址或相对路径。

如果需要调整图片大小,可以根据博客平台的支持情况使用 HTML:

<img src="图片地址" width="500" alt="示例图片">

九、表格语法

Markdown 可以通过 | 和 - 快速创建表格。

| 名称 | 类型 | 说明 |
|---|---|---|
| HTML | 标记语言 | 网页结构 |
| CSS | 样式语言 | 网页美化 |
| JavaScript | 编程语言 | 网页交互 |

显示效果:

名称

类型

说明

HTML

标记语言

网页结构

CSS

样式语言

网页美化

JavaScript

编程语言

网页交互

表格对齐方式

可以通过冒号控制内容的对齐方式。

| 左对齐 | 居中对齐 | 右对齐 |
|:---|:---:|---:|
| 内容A | 内容B | 内容C |
| 内容D | 内容E | 内容F |

十、分割线语法

使用三个或更多的 -、* 或 _ 可以创建分割线。

---

***

___

显示效果:

十一、转义字符

如果需要显示 Markdown 本身的特殊符号,可以在符号前添加反斜杠 \。

例如:

\*这里不会变成斜体\*

\# 这里不会变成标题

\`这里不会变成代码\`

常见需要转义的符号:

符号

用途

\*

星号

\#

井号

\>

引用符号

\_

下划线

```

反引号

\\

反斜杠

十二、HTML 扩展语法

部分 Markdown 编辑器支持直接嵌入 HTML,可以实现更多排版效果。

1. 文字颜色

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

2. 文字居中

<p align="center">这是一段居中的文字</p>

3. 图片居中

<p align="center">
  <img src="图片地址" width="400">
</p>

4. 折叠内容

<details>
  <summary>点击展开详细内容</summary>

  这里是隐藏的内容。

</details>

注意:HTML 扩展语法并非所有 Markdown 平台都支持,具体效果取决于编辑器和渲染引擎。

十三、数学公式

如果编辑器支持 LaTeX 数学公式,可以使用 $ 或 $$ 编写数学表达式。

行内公式:

这是一个数学公式:$E=mc^2$

这是一个数学公式:E=mc2E=mc^2

独立公式:

$$
a^2+b^2=c^2
$$

效果:

a2+b2=c2a^2+b^2=c^2

十四、常用特殊符号

Markdown 可以直接输入 Unicode 特殊字符,也可以根据平台支持情况使用 HTML 实体。

符号

含义

©

版权符号

®

注册商标

™

商标符号

✓

正确

✗

错误

★

星星

→

右箭头

←

左箭头

↑

上箭头

↓

下箭头

♥

爱心

¥

人民币

十五、Markdown 常用语法速查表

下面整理了一份日常写博客时经常使用的 Markdown 语法,建议收藏。

功能

Markdown 语法

一级标题

# 标题

二级标题

## 标题

三级标题

### 标题

粗体

**文字**

斜体

*文字*

删除线

~~文字~~

无序列表

- 内容

有序列表

1. 内容

引用

> 内容

行内代码

代码

代码块

```语言

超链接

[名称](地址)

图片

![描述](地址)

分割线

---

表格

\|标题\|标题\|

任务清单

- [ ] 内容

转义字符

\*

十六、推荐 Markdown 编辑器

如果你经常使用 Markdown 编写博客、技术文档或个人笔记,可以尝试以下工具。

1. Typora

Typora — Markdown as WYSIWYG as it can get | by Martin Eder | Medium

medium.com

一款简洁美观的 Markdown 编辑器,支持实时预览、图片管理和多种导出格式。

官网:https://typora.io/

2. Obsidian

How to use Obsidian with Claude Code | by Algo Insights | Coding Nexus | Jan, 2026 | Medium

medium.com

适合搭建个人知识库,支持双向链接、标签管理以及丰富的插件生态。

官网:https://obsidian.md/

3. Visual Studio Code

How to Preview Markdown in Visual Studio Code

itsfoss.com

适合开发者使用,支持 Markdown 编辑、实时预览以及丰富的扩展插件。

官网:https://code.visualstudio.com/

结语

Markdown 的优势在于简单、高效、易维护。掌握以上语法,基本就可以满足日常博客写作、技术文档编写和知识整理的需求。

对于个人博客而言,合理使用标题、引用、代码块、图片和表格,不仅能让文章结构更加清晰,也能提升读者的阅读体验。

好的排版不只是让文章更漂亮,更是让知识更容易被理解和传播。

文章作者:LucianZ · Markdown 入门与使用指南