Markdown 语法入门
Markdown 语法完全入门
Markdown 是轻量级标记语言,语法简洁易读,适用于博客、文档、代码注释等场景,以下是核心语法示例
一、标题语法
使用 # 表示标题,# 数量对应级别(1-6 级),# 与文本间留 1 个空格。
语法示例:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注意:超过 6 个 #不再识别为标题。
二、列表语法
1. 无序列表
使用 -、* 或 + 作为标记,标记与文本间留 1 个空格,缩进 1 个 Tab/4 个空格实现嵌套。
语法示例:
- 无序列表项 1
- 无序列表项 2
- 嵌套列表项
- 嵌套列表项
* 无序列表项 1
+ 无序列表项 1
2. 有序列表
使用「数字 + 英文句点 + 空格」,数字无需有序,显示时自动排序,支持嵌套。
语法示例:
1. 有序列表项 1
2. 有序列表项 2
3. 嵌套列表项
5. 有序列表项 3
三、代码块语法
1. 行内代码
用反引号 ` 包裹代码片段。
语法示例:
行内代码:`print("Hello World!")`、`var a = 1`
2. 块级代码
用三个反引号 ``` 包裹,开头可指定语言实现语法高亮。
语法示例:
```python
def add(a, b):
; return a + b
result = add(3, 5)
print(f"结果:{result}")
function multiply(x, y) {
; return x * y;
}
let res = multiply(4, 6);
> 注意:代码含反引号时,用不同数量反引号包裹(如 `` ``` `print("Hello")` ```)。
## 四、文本格式语法
#### 语法示例:
```markdown
- 斜体:*斜体文本* _斜体文本_
- 加粗:**加粗文本** __加粗文本__
- 加粗斜体:***加粗斜体文本*** ___加粗斜体文本___
- 删除线:~~删除线文本~~
- 下划线:下划线文本部分编辑器支持)
五、链接与图片语法
1. 链接
语法:[链接文本](链接地址 "可选标题")
语法示例:
- 外部链接:[GitHub官网](https://github.com "GitHub")
- 内部锚点:[回到顶部](#一级标题)
- 无标题链接:[百度](https://www.baidu.com)
2. 图片
语法:,alt 文本为加载失败时显示内容。
语法示例:
- 网络图片:
- 本地图片:
注意:本地图片建议用相对路径。
六、引用语法
使用 > 表示引用,多组 > 实现嵌套,可包含其他语法。
语法示例:
> 一级引用
> 引用换行
>> 二级嵌套引用
>>> 三级嵌套引用
>
> 引用内支持**加粗**、`行内代码`、[链接](https://www.baidu.com)
七、分割线语法
使用 ---、*** 或 ___,需单独一行,前后建议空行。
语法示例:
文本内容1
---
文本内容2
***
文本内容3
八、表格语法
用 | 分隔列,- 分隔表头与内容,: 指定对齐方式。
语法示例:
| 姓名 | 年龄 | 职业 |
| ---- | ---- | ---- |
| 张三 | 25 | 程序员 |
| 李四 | 30 | 产品经理 |
# 对齐方式示例
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | ----: |
| 内容1 | 内容2 | 内容3 |
注意:
-至少 1 个,
:位于
-左侧(左对齐)、两侧(居中)、右侧(右对齐)。
九、其他常用语法
1. 换行
每行末尾加「两个空格 + 回车」,或空一行分段。
语法示例:
这是第一行(末尾加两个空格)  
这是第二行
这是第三行
这是第四行
2. 转义字符
语法符号前加 \ 可显示原符号(如 #、*、| 等)。
语法示例:
- 显示#:\# 这不是标题
- 显示*:\* 这不是斜体
- 显示|:表格分隔符是 \|
评论区
共 0 条