⌨ 技术

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文本](图片地址 "可选标题"),alt 文本为加载失败时显示内容。

语法示例:

- 网络图片:![Markdown logo](https://markdown-here.com/img/icon256.png "Markdown图标")
- 本地图片:![本地图片](./images/markdown.jpg)

注意:本地图片建议用相对路径。

六、引用语法

使用 > 表示引用,多组 > 实现嵌套,可包含其他语法。

语法示例:

> 一级引用
> 引用换行
>> 二级嵌套引用
>>> 三级嵌套引用
>
> 引用内支持**加粗**、`行内代码`、[链接](https://www.baidu.com)

七、分割线语法

使用 ---***___,需单独一行,前后建议空行。

语法示例:

文本内容1
---

文本内容2
***

文本内容3

八、表格语法

| 分隔列,- 分隔表头与内容,: 指定对齐方式。

语法示例:

| 姓名 | 年龄 | 职业 |
| ---- | ---- | ---- |
| 张三 | 25 | 程序员 |
| 李四 | 30 | 产品经理 |
# 对齐方式示例
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | ----: |
| 内容1 | 内容2 | 内容3 |

注意:

-

至少 1 个,

:

位于

-

左侧(左对齐)、两侧(居中)、右侧(右对齐)。

九、其他常用语法

1. 换行

每行末尾加「两个空格 + 回车」,或空一行分段。

语法示例:

这是第一行(末尾加两个空格)  

这是第二行

这是第三行

这是第四行

2. 转义字符

语法符号前加 \ 可显示原符号(如 #、*、| 等)。

语法示例:

- 显示#:\# 这不是标题
- 显示*:\* 这不是斜体
- 显示|:表格分隔符是 \|

评论区

共 0 条
🍃 还没有评论,沙发虚位以待~
🚇

穿越虫洞?

虫洞会把你随机传送到另一位陌生博主的网站——
可能是技术大佬,也可能是诗歌爱好者,开盲盒的时间到了。

森林精灵