mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4
417 字
1 分钟
Markdown 语法完整指南
2026-07-23

什么是 Markdown#

Markdown 是一种轻量级标记语言,用纯文本就能写出格式丰富的文档。这篇文章涵盖了所有常用语法。

标题#

在文字前加 # 号,# 越多标题层级越低:

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

文字样式#

语法效果
**粗体**粗体
*斜体*斜体
***粗斜体***粗斜体
~~删除线~~删除线
`行内代码`行内代码

链接与图片#

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

链接可以加上标题(鼠标悬停显示):

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

列表#

无序列表用 -*+

- 项目一
- 项目二
- 子项目
- 子项目

有序列表用数字加点:

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

引用#

在文字前加 >

这是一段引用。

引用可以多行,也可以包含其他 Markdown 元素。

多层引用用 >>

第一层

第二层

代码块#

用三个反引号包裹,后面写语言名会有语法高亮:

function hello() {
console.log("Hello, World!");
}
def greet(name):
return f"你好,{name}"

分割线#

三个或以上的 ---


表格#

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容 | 内容 | 内容 |
| 更长内容 | 内容 | 内容 |

效果:

左对齐居中右对齐
内容内容内容
更长内容内容内容

任务列表#

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

效果:

  • 已完成任务
  • 未完成任务
  • 待办事项

脚注#

这是一段带脚注的文字[^1]。
[^1]: 这是脚注内容。

数学公式(KaTeX)#

行内公式用 $ 包裹:E=mc2E = mc^2

块级公式用 $$ 包裹:

0ex2dx=π2\int_0^\infty e^{-x^2} dx = \frac{\sqrt{\pi}}{2}

Mermaid 图表#

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

提示框#

本主题支持多种提示框,用 ::: 包裹:

NOTE

这是一条普通提示。

TIP

这是一条技巧提示。

WARNING

这是一条警告。

CAUTION

这是一条注意事项。

HTML 混用#

Markdown 里可以直接写 HTML,比如折叠面板:

点击展开

这里是被隐藏的内容,可以放更多信息。

  • 参考链接一
  • 参考链接二

总结#

以上就是 Markdown 的常用语法。写博客用这些完全够了。平时边写边查,慢慢就记住了。

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Markdown 语法完整指南
https://teaparty.top/posts/markdown-语法完整指南/
作者
Ray
发布于
2026-07-23
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时

目录