Markdown基本语法

Markdown 是一种轻量级的标记语言,语法简洁、易读易写。以下是 Markdown 的基本语法 汇总(基于通用标准,如 CommonMark):


1. 标题(Headers)

使用 # 表示标题,# 的数量代表层级(最多6级):

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 段落与换行

  • 段落由一个或多个连续的文本行组成,段落之间需用空行分隔。
  • 在行尾添加 两个或以上空格 可实现强制换行:
1
2
3
4
这是第一段。

这是第二段。
这是同一段内的新行(注意行尾有两个空格)。

3. 强调(Emphasis)

  • 粗体:用 **__ 包裹文字
    1
    **粗体**__粗体__
  • 斜体:用 *_ 包裹文字
    1
    *斜体*_斜体_
  • 粗斜体
    1
    ***粗斜体***___粗斜体___

4. 列表(Lists)

无序列表

使用 -+*

1
2
3
- 项目一
- 项目二
- 子项目(缩进两个空格或一个制表符)

有序列表

使用数字加英文句点:

1
2
3
1. 第一项
2. 第二项
1. 子项(缩进)

注意:数字不必严格递增,但建议按顺序写以提高可读性。


5. 链接(Links)

1
[链接文字](https://example.com "可选标题")

例如:

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

6. 图片(Images)

语法与链接类似,前面加 !

1
![替代文字](/path/to/image.jpg "可选标题")

例如:

1
![Logo](logo.png)

自定义尺寸

1
<img src="image.jpg" alt="描述" style="width: 300px; height: auto;">

7. 代码(Code)

  • 行内代码:用反引号包裹

    1
    使用 `console.log()` 输出信息。
  • 代码块:用三个反引号(```)包围,并可指定语言,如:javascript

    1
    2
    3
    function hello() {
    console.log("Hello, Markdown!");
    }

8. 引用(Blockquotes)

使用 > 开头:

1
2
3
> 这是一个引用。
>
> > 嵌套引用

9. 分隔线(Horizontal Rule)

使用三个或以上的 -*_(中间可有空格):

1
2
3
---
***
___

10. 表格(Tables)

使用 |- 创建:

1
2
3
4
| 姓名   | 年龄 | 城市     |
|--------|------|----------|
| 张三 | 28 | 北京 |
| 李四 | 32 | 上海 |

对齐方式(可选):

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

11. 转义字符(Escaping)

在特殊字符前加 \ 可转义,如:

1
\*这不是斜体\*

常见需转义字符:\ * _ {} [] () # + - . ! |