Markdown基础语法

Markdown 基础语法笔记

---

1. 标题语法（1-6级）

通过 # 数量区分标题级别，# 与文本间需加 1 个空格；若需展示「# 符号本身」，用 \ 转义。

标题级别	语法格式	渲染效果	说明
1级标题	# 一级标题	# 一级标题	文档主标题，字体最大
2级标题	## 二级标题	## 二级标题	章节标题
3级标题	### 三级标题	### 三级标题	小节标题
4级标题	#### 四级标题	#### 四级标题	子项说明
5级标题	##### 五级标题	##### 五级标题	更细层级
6级标题	###### 六级标题	###### 六级标题	最小级别（仅支持6级）

🔍 转义示例：若想显示 # 不被渲染的标题，需写 \# 不被渲染的标题

2. 段落与换行

• 说明：无需特殊标记，直接写文字即为段落；关键是通过「空行+换行技巧」优化排版。

2.1 基础规则

• 普通段落：直接输入文字，段落之间空 1 行即可分隔（避免连在一起）。

• 强制换行：在需要换行的句子末尾加「2 个空格」再按回车（部分编辑器支持单回车，但「2 个空格」是通用标准）。

2.2 示例演示

• 正确写法：
  这是第一段文字：无需特殊标记，直接书写即可。
  这行末尾加了 2 个空格（看末尾）
  所以下一行会强制换行显示。

• 这是第二段文字：与第一段之间空了 1 行，自动分隔为独立段落。

• 错误写法：
  这是第一段文字，末尾没加空格直接回车
  下一行会和它连在一起显示。
  这是第二段文字，和第一段没空行，也会连在一起。

3. 强调

3.1 斜体

• 说明：用*或_包裹文本
• 举例代码：

*这是斜体* 或 _这也是斜体_

• 效果：这是斜体 或 这也是斜体

3.2 粗体

• 说明：用**或__包裹文本
• 举例代码：

**这是粗体** 或 __这也是粗体__

• 效果：这是斜体 或 这也是斜体

3.3 粗斜体

• 说明：用***包裹文本
• 举例代码：

***这是粗斜体***

• 效果：这是粗斜体

3.4 删除线

• 说明：用~~包裹文本
• 举例代码：

~~这是删除线~~

• 效果：这是删除线

4. 列表

4.1 无序列表

• 说明：用 -、* 或 + 开头，符号后必须加1个空格；子列表需缩进2个空格。
• 举例代码：

+ 主列表项1
- 主列表项2
  - 一级列表项2.1
    - 二级列表项2.1.1
      - 三级列表项2.1.1.1
  - 一级列表项2.2
* 主列表项3

• 效果：

• 主列表项1

• 主列表项2
  • 一级列表项2.1
    • 二级列表项2.1.1
      • 三级列表项2.1.1.1
  • 一级列表项2.2

• 主列表项3

4.2 有序列表

• 说明：Markdown 有序列表的编号仅为 “形式提示”，渲染时会自动按书写顺序生成连续数字（无论写1.还是2.，都不影响最终连续编号）。这样设计是为了：
  降低书写负担：无需手动维护编号连续性（插入/删除项时，不用修改后续所有编号）。
  保持语法简洁：聚焦 “快速列步骤” 的基础需求，不支持复杂层级编号（如2.1）。
• 方法：说明：用「数字 + .」开头（如 1.），符号后加 1 个空格；编号不影响顺序（按书写顺序显示），子列表缩进 2 个空格。
• 举例代码：

1. 第一步
2. 第二步
  1. 子步骤2.1（缩进2空格）
  2. 子步骤2.2
3. 第三步

• 效果：

1. 第一步
2. 第二步
3. 子步骤2.1（缩进2空格）
4. 子步骤2.2
5. 第三步

5. 链接

链接类型	语法格式	举例代码	渲染效果
普通链接	[显示文本](链接地址)	[GitHub官网](https://github.com)	GitHub官网
带标题的链接	[显示文本](链接地址 "鼠标悬停时显示的标题")	[百度](https://baidu.com "点击跳转到百度")	百度
自动识别 URL	直接写网址（无需标记）	https://zhihu.com	https://zhihu.com
内部锚点链接	[跳转文本](#目标标题的id)	[跳转到标题1](#1-标题语法1-6级)	跳转到标题1

• 锚点说明：🔍 锚点链接说明：目标标题需去掉特殊符号，空格替换为 -（如「2. 段落与换行」的 id 是 2-段落与换行）。

6. 图片

与链接语法类似，仅多一个!，用于插入图片。

图片类型	语法格式	举例代码	渲染效果
基础图片		
带标题的图片		

• 🔍 注意事项：
• 本地图片需写相对路径（如 ./images/pic.jpg）
• 网络图片需确保链接可访问，否则显示「加载失败文字」

7. 引用

用于标记引用内容（如名言、引言），支持多级嵌套。

• 说明：
  用 > 开头，符号后加 1 个空格；多级引用叠加 >（如 >> 表示二级引用）。
  多级嵌套隔断行中间需要添加>
• 举例代码

> 一级引用：这是最外层的引用
> 
> > 二级引用：嵌套在一级引用内（多一个>）
> > 
> > > 三级引用：继续嵌套（再多一个>）
> 
> 回到一级引用

• 渲染效果：

一级引用：这是最外层的引用

二级引用：嵌套在一级引用内（多一个>）

三级引用：继续嵌套（再多一个>）

回到一级引用

8. 分割线

用于分隔不同内容区块，视觉上更清晰。

• 说明：用---、***或___（至少 3 个符号），单独占一行，前后建议空行避免与其他内容冲突。
• 举例代码：

上方内容
---
中间用分割线分隔
***
下方内容

• 渲染效果：
• 上方内容

---

中间用分割线分隔

---

下方内容

9. 表格

用于展示结构化数据，支持对齐方式设置。

• 说明：
  用 | 分隔列，- 分隔表头与内容（至少 3 个 -）
  用 : 控制对齐：:--- 左对齐、---:右对齐、:---:居中对齐
  表格前后建议空行，避免格式错乱

| 姓名 | 年龄 | 职业   | 薪资   |
| :--- | :---: | ---:  | :---: |
| 张三 | 25    | 程序员 | 15k   |
| 李四 | 30    | 设计师 | 18k   |

• 渲染效果：

姓名	年龄	职业	薪资
张三	25	程序员	15k
李四	30	设计师	18k

10. 代码块

用于展示代码片段，支持单行和多行，可指定语言实现语法高亮。

10.1 单行代码

• 说明：用单个反引号（`）包裹代码，适合短变量、命令。
• 举例代码：

`print("Hello Markdown")` 或 `npm install`

• 渲染效果：print("Hello Markdown") 或 npm install

10.2 多行代码块

• 说明：用三个反引号（）包裹代码，开头的后可加语言名称（如 python、bash）实现语法高亮。
• 举例代码：

```Python
print('Hello,World!')
```

• 渲染效果:

print('Hello,World!')

• 🔍 转义反引号：若代码中包含，需用更多反引号包裹（如用````包裹含的代码）。