这里是广告位,没人找我放广告!

Markdown 详细语法大全

19次阅读
没有评论

Markdown 详细语法大全

Markdown 是一种轻量级标记语言,语法简洁易记,广泛用于写作、文档、博客、GitHub 等场景。以下从基础、进阶、扩展、HTML 兼容四方面,整理完整可直接使用的语法(含代码与效果)。


一、基础语法(必学,覆盖 80% 场景)

1. 标题(1–6 级)

# 开头,# 数量 = 标题级别(1 级最大,6 级最小),# 后必须加空格

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

# 一级标题(底线写法)
====================

## 二级标题(底线写法)
--------------------

2. 文本样式

*斜体* 或 _斜体_
**粗体** 或 __粗体__
***粗斜体*** 或 ___粗斜体___
~~删除线~~
<u>下划线(HTML)</u>
==高亮==(部分编辑器支持)

效果:斜体粗体粗斜体删除线、下划线、==高亮==

3. 段落与换行

  • 段落:直接写,段落间空一行
  • 强制换行:行尾加 2 个空格 + 回车<br>
第一行(结尾加2空格)  
第二行
第三行<br>第四行

4. 引用(支持嵌套)

> 开头,多层嵌套用 >>>>>

> 一级引用
>> 二级嵌套引用
>>> 三级嵌套引用
>
> 引用内可以**加粗**、[链接](/)、列表
> 1. 有序
> - 无序

5. 列表

无序列表

-*+ 任一符号 + 空格

- 项目1
- 项目2
  - 子项(缩进2空格/制表符)
  - 子项
* 项目3

有序列表

数字. 空格(数字不影响实际排序)

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

任务列表(GitHub 风格)

- [x] 已完成
- [ ] 未完成
- [ ] 待办事项

6. 代码

行内代码

用反引号 ` 包裹

执行 `npm install` 安装依赖

效果:执行 npm install 安装依赖

代码块(语法高亮)

三个反引号 ``` 包裹,开头指定语言(python/js/java/cpp 等)

```python
def hello():
    print("Hello Markdown")
```

7. 链接

// 内联链接
[显示文本](URL "鼠标悬停标题")
[百度](https://www.baidu.com "百度一下")

// 引用式链接(适合重复使用)
[谷歌][1]
[1]: https://www.google.com "Google"

// 自动链接
<https://www.example.com>
<user@mail.com>

8. 图片

语法与链接类似,开头加 !

// 内联
![替代文字](URL "标题")
![Logo](https://example.com/logo.png "站点Logo")

// 引用式
![图1][img1]
[img1]: ./pic.jpg "图片说明"

// 图片+链接(把图片语法放进链接括号)
[![图](pic.jpg)](https://example.com)

9. 分割线

一行用 ---/***/___(3个以上,可中间加空格)

---
***
___
- - -

二、进阶语法(表格、脚注、定义列表)

1. 表格

  • | 分隔列,- 分隔表头与内容
  • : 控制对齐:左(默认)、:--- 左、:---: 中、---:
| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容1   | 内容2 | 内容3  |
| **长文本** | *斜体* | ~~删除~~ |

2. 脚注

文本内容[^1]
更多内容[^2]

[^1]: 脚注1说明
[^2]: 脚注2说明(支持**多行**与格式)

3. 定义列表

术语1
: 定义1
: 定义2

术语2
: 定义内容

三、扩展语法(常用编辑器/GitHub 支持)

1. 目录 TOC

@[toc]  // 多数编辑器/博客
[[toc]] // VuePress、GitBook

2. 数学公式(LaTeX)

// 行内
$E=mc^2$,$\sin^2x+\cos^2x=1$

// 块级
$$
\sum_{i=1}^n a_i = \int_0^\infty f(x)dx
$$

3. 流程图/时序图(Mermaid)

```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
```

4. 表情符号

:emoji名称:

:smile: :star: :rocket: :heavy_check_mark:

效果:😄 ⭐ 🚀 ✅


四、HTML 兼容(复杂排版)

Markdown 支持直接写 HTML 标签:

<span style="color:red;">红色文字</span>
<p align="center">居中段落</p>
<div style="font-size:20px;">大号字体</div>
<br> <hr> <kbd>Ctrl</kbd> <mark>高亮</mark>

五、转义字符

特殊符号(# * ~ [ ] ( ) 等)前加 \ 显示原字符:

\# 不是标题
\* 不是斜体
\` 显示反引号

六、速记清单

  • 标题:#
  • 加粗:** **
  • 斜体:* *
  • 代码:` ` /
  • 链接:[ ]( )
  • 图片:![ ]( )
  • 列表:- / 1.
  • 引用:>
  • 表格:| |
  • 分割线:---

要不要我帮你整理一份可直接复制的 Markdown 语法速查表(PDF/MD 版)

正文完
 0