Markdown常用语法

1. 标题

使用 # 表示标题,# 数量对应 HTML 的 <h1><h6>

1
2
3
4
# 一级标题
## 二级标题
### 三级标题
#### 四级标题

💡 提示:文章通常只有一个 # 一级标题,即文章主标题。

2. 段落与换行

段落由一个或多个连续的文本行组成,段落之间需用空行分隔。

1
2
3
这是第一段。

这是第二段。

强制换行:在行尾添加两个或以上空格,或使用 <br> 标签。

1
2
这是第一行。  
这是第二行(前面有两个空格)。

3. 强调(粗体与斜体)

  • *斜体*_斜体_斜体
  • **粗体**__粗体__粗体
  • ***粗斜体***粗斜体

4. 列表

无序列表

使用 -*+

1
2
3
4
- 苹果
- 香蕉
- 芭蕉(缩进两个空格表示子项)
- 红香蕉

有序列表

使用数字加点:

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

注意:数字不必严格连续,渲染后会自动排序。

5. 链接与图片

链接

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

效果:百度

图片

1
![替代文本](https://example.com/image.jpg "可选标题")

图片语法与链接相似,只是开头多一个 !

6. 引用(Blockquote)

使用 > 表示引用:

1
2
3
4
> 这是一段引用文字。
> 可以跨多行。
>
> —— 鲁迅

效果:

这是一段引用文字。
可以跨多行。

—— 鲁迅

7. 代码

  • 行内代码:用反引号包裹,如 `console.log()`console.log()
  • 代码块:用三个反引号包裹,并可指定语言:
1
2
3
```python
def hello():
print("Hello, Markdown!")
1
2
3
4
5
6

渲染后支持语法高亮(取决于解析器):

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

8. 分隔线(Horizontal Rule)

使用三个或以上 -*_

1
---

效果:

9. 表格

使用 |- 创建表格:

1
2
3
4
| 姓名   | 年龄 | 城市     |
|--------|------|----------|
| 小明 | 25 | 北京 |
| 小红 | 22 | 上海 |

对齐方式(可选):

  • :--- 左对齐
  • :---: 居中
  • ---: 右对齐
1
2
3
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| A | B | C |

10. 任务列表(Task List)

常用于 GitHub 或支持扩展的编辑器:

1
2
3
- [x] 完成 Markdown 教程
- [ ] 发布博客
- [ ] 推广文章

效果(在支持的平台):

  • 完成 Markdown 教程
  • 发布博客
  • 推广文章

转义字符

使用反斜杠 \ 转义特殊字符,如:

1
\*这不是斜体\*

脚注(部分解析器支持)

1
2
3
这是引用内容[^1]。

[^1]: 这是脚注的详细说明。

自动链接

直接写 URL(带尖括号或不带):

1
访问 <https://github.com> 获取更多资源。

参考资料