跳到主要内容
欢迎光临本站
魔网
登录

Markdown 从入门到精通（完整语法教程）

Markdown 是一种轻量级标记语言，语法简单、阅读方便，目前广泛应用于博客、技术文档、知识库、README、API 文档等。

一、标题

Markdown 支持 1~6 级标题。

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、普通文本

直接输入即可。

这是第一行。

这是第二行。

这是第三行。

三、换行

方法一（推荐）

空一行。

第一行

第二行

方法二

行尾两个空格

第一行··
第二行

方法三

HTML

第一行<br>
第二行

四、强调文字

粗体

**粗体**

粗体

斜体

*斜体*

斜体

粗斜体

***粗斜体***

粗斜体

删除线

~~删除线~~

删除线

下划线（HTML）

<u>下划线</u>

下划线

五、引用

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

效果：

一级引用

二级引用

三级引用

六、分割线

---

***

___

七、无序列表

- 苹果
- 香蕉
- 西瓜
  • 苹果
  • 香蕉
  • 西瓜

也可以

* 苹果
* 香蕉
* 西瓜

八、有序列表

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

九、任务列表（Todo）

- [ ] 未完成
- [x] 已完成
  • [ ] 未完成
  • [x] 已完成

十、嵌套列表

1. 前端
    - HTML
    - CSS
    - JavaScript

2. 后端
    - PHP
    - Java
    - Go

  1. 前端

    • HTML
    • CSS
    • JavaScript

  2. 后端

    • PHP
    • Java
    • Go

十一、代码

行内代码

使用 `printf()` 输出内容。

使用 printf() 输出内容。

多行代码

```php
echo "Hello World";

```php
echo "Hello World";

支持语言：

  • php
  • java
  • javascript
  • typescript
  • html
  • css
  • scss
  • c
  • cpp
  • csharp
  • python
  • go
  • rust
  • sql
  • json
  • xml
  • yaml
  • bash
  • shell
  • powershell
  • dart
  • kotlin
  • swift

十二、图片

![图片描述](https://example.com/image.jpg)

带标题：

![LOGO](https://example.com/logo.png "网站Logo")

HTML：

<img src="https://example.com/logo.png" width="300">

十三、超链接

[OpenAI](https://openai.com)

自动识别：

https://openai.com

十四、邮箱

<example@qq.com>

十五、表格

| 姓名 | 年龄 | 城市 |
|------|-----:|:----:|
| 张三 | 18 | 北京 |
| 李四 | 20 | 上海 |
| 王五 | 25 | 深圳 |
姓名 年龄 城市
张三 18 北京
李四 20 上海
王五 25 深圳

十六、对齐方式

左对齐

|姓名|
|:---|

右对齐

|姓名|
|---:|

居中

|姓名|
|:---:|

十七、脚注

这是脚注[^1]

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

十八、转义字符

\#
\*
\`
\[
\]

效果：

* ` ( )

十九、HTML 混写

Markdown 支持大量 HTML。

<div align="center">

<h2>居中标题</h2>

<p>支持HTML</p>

</div>

二十、文字颜色

<span style="color:red">红色</span>

<span style="color:#409EFF">蓝色</span>

二十一、字体大小

<span style="font-size:30px">
大号字体
</span>

二十二、文字居中

<center>居中文字</center>

或者

<div align="center">
居中文字
</div>

二十三、图片居中

<div align="center">

<img src="logo.png" width="300">

</div>

二十四、图片缩放

<img src="logo.png" width="200">

<img src="logo.png" height="100">

<img src="logo.png" width="50%">

二十五、视频（HTML）

<video controls width="600">

<source src="demo.mp4">

</video>

二十六、音频

<audio controls>

<source src="music.mp3">

</audio>

二十七、B站视频

<iframe
src="//player.bilibili.com/player.html?bvid=BVxxxxxxxx"
width="800"
height="450"
allowfullscreen>
</iframe>

二十八、Emoji

😀 😄 😆 😂 🤣 😊 😍 👍 ❤️ 🎉 🚀

😀 😄 😆 😂 🤣 😊 😍 👍 ❤️ 🎉 🚀

GitHub 风格：

:smile:
:heart:
:rocket:
:fire:

二十九、数学公式（KaTeX）

行内：

$E=mc^2$

块级：

$$
x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
$$

三十、流程图（Mermaid）

```mermaid
graph LR

A-->B

B-->C

C-->D

---

# 三十一、时序图

````markdown
```mermaid
sequenceDiagram

用户->>服务器: 请求

服务器-->>用户: 返回

---

# 三十二、甘特图

````markdown
```mermaid
gantt

title 项目计划

dateFormat YYYY-MM-DD

section 开发

设计:done,2026-01-01,5d

编码:active,2026-01-06,10d

测试:2026-01-18,5d

---

# 三十三、思维导图（部分编辑器支持）

````markdown
```mermaid
mindmap

root

Markdown

标题

列表

代码

图片

表格

---

# 三十四、目录

部分编辑器支持：

```markdown
[TOC]

或

[[toc]]

三十五、定义列表（部分支持）

PHP

: 世界上最好的语言之一

Java

: 企业开发语言

三十六、键盘按键

HTML：

<kbd>Ctrl</kbd> + <kbd>C</kbd>

效果：

Ctrl + C

三十七、标记高亮

部分支持：

==高亮==

效果：

==高亮==

三十八、上下标

上标：

X^2^

下标：

H~2~O

三十九、折叠内容

HTML：

<details>

<summary>点击展开</summary>

这里是隐藏内容。

</details>

四十、综合示例

爱看影视

一个现代化影视资源站

功能

  • [x] 在线观看
  • [x] 下载资源
  • [x] 收藏影片
  • [ ] AI 推荐
名称 类型 状态
首页 页面 ✅
分类 页面 ✅
搜索 页面 ✅
会员 页面 开发中

代码：

<?php

echo "欢迎来到爱看影视";

?>

图片：

![Logo](logo.png)

链接：

[访问官网](https://example.com)

Markdown 支持情况

功能 GitHub Typora Obsidian VS Code Emlog Halo
标题 ✅ ✅ ✅ ✅ ✅ ✅
图片 ✅ ✅ ✅ ✅ ✅ ✅
表格 ✅ ✅ ✅ ✅ ✅ ✅
HTML 部分 ✅ ✅ ✅ 部分 部分
Mermaid ✅ ✅ ✅ 插件 ❌ 插件
KaTeX ✅ ✅ ✅ 插件 ❌ 插件
Emoji ✅ ✅ ✅ ✅ ✅ ✅

总结

Markdown 的核心语法非常简单，但配合 HTML、Mermaid、KaTeX 等扩展，可以完成从普通文档、博客文章，到技术文档、API 文档、项目说明书等各种场景。建议优先掌握标题、列表、引用、代码块、表格、图片和链接等基础语法，再根据编辑器支持情况使用高级功能。

用户信息
热门文章
随机推荐
最新评论