Markdown基础

1.标题

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

2.段落与换行

段落：两个段落之间空一行
换行：在一行末尾加上两个空格，然后回车

1
2
3
这是第一段。  

这是第二段

3.文字样式

效果 语法 示例
斜体 *斜体* 或 _斜体_ 斜体
粗体 **粗体** 或 __粗体__ 粗体
粗斜体 ***粗斜体*** 粗斜体
删除线 ~~删除线~~ 删除线
行内代码 `代码` print("hello")

4. 列表

4.1无序列表

使用 -、+ 或 *

  • 苹果
  • 香蕉
    • 子项（缩进2空格）
  • 橙子
4.2有序列表

使用 数字 + .

  1. 第一步
  2. 第二步
    1. 子步骤（缩进3空格）
  3. 第三步
1
2
3
4
1. 第一步
2. 第二步
   1. 子步骤（缩进3空格）
3. 第三步
4.3任务清单（GitHub 风格）
  • 已完成
  • 未完成
1
2
- [x] 已完成
- [ ] 未完成

5.链接与图片

5.1链接
1
2
3
[显示文字](https://example.com "可选标题")
<https://自动链接.com>
[相对路径](./other.md)
5.2图片
1
![替代文本](图片URL "可选标题")

6.引用

效果：

这是一段引用。

嵌套引用

引用中可以包含 Markdown 语法

1
2
3
4
5
> 这是一段引用。
> 
> > 嵌套引用
>
> 引用中可以包含 **Markdown** 语法

7.代码块

使用三个反引号 ` 包裹，并指定语言（可选）

1
2
def hello():
    print("Hello, Markdown!")

8.表格

左对齐 居中对齐 右对齐
内容1 内容2 内容3
内容4 内容5 内容6 
1
2
3
4
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容1  | 内容2    | 内容3  |
| 内容4  | 内容5    | 内容6  |

9. 分隔线

分隔线用于在内容中创建视觉上的分割，通常表示主题切换或段落分隔。

语法规则

在一行中连续输入 三个或以上 的相同字符即可创建分隔线。支持的字符有：

  • 短横线 -
  • 星号 *
  • 下划线 _

示例：

1
2
3
---
***
___

注意事项:

1.行内不能有其他字符：分隔线必须独立成行，前后不能有文字或空格（行首行尾的空格会被忽略）。

2.短横线避免冲突：如果上一行是文字，单独一行 — 可能会被解析为二级标题（Setext 风格）。建议在分隔线上方留一个空行。

3.可混合使用：理论上可以混合不同符号（如 -*-），但推荐统一使用同一种符号，避免不可预料的渲染结果。

4.加空格也可：符号之间可以加空格，如 - - - 效果与 — 相同。

  • 正确写法：
1
2
3
4
5
这是上文

---

这是下文
  • 错误写法（会导致不渲染或歧义）：
1
2
3
这是上文
---    ← 紧接上文没有空行，可能被当作二级标题
--- 后面有文字   ← 行内还有其他内容

10.转义字符

使用反斜线 \ 让特殊字符原样显示，而不被解析为 Markdown 语法。

需要转义的特殊字符
字符 名称 通常用途
\ 反斜线 转义符本身
` 反引号 行内代码
* 星号 斜体、粗体、列表
_ 下划线 斜体、粗体
{} 花括号 某些扩展语法
[] 方括号 链接、图片
() 圆括号 链接、图片的 URL
# 井号 标题
+ 加号 无序列表
- 减号 无序列表、分隔线
. 点号 有序列表
! 感叹号 图片
| 竖线 表格
< 小于号 HTML 标签、自动链接
> 大于号 引用
: 冒号 表格对齐、定义列表
~ 波浪号 删除线

语法示例

*正常斜体*  
\*不是斜体\*

# 一级标题  
\# 不是标题

[链接](https://example.com)  
\[不是链接\](https://example.com)

_斜体_  
\_不是斜体\_

~~删除线~~  
\~~不是删除线\~~