Markdown快速入门教程

Markdown 是一种轻量级标记语言,由约翰·格鲁伯(John Gruber)于2004年创建。它允许人们使用易读易写的纯文本格式编写文档,然后可将其转换成有效的 XHTML 或 HTML 文档。目前,Markdown 已被广泛应用于博客、技术文档、笔记软件(如 Notion、Obsidian)以及版本控制平台(如 GitHub)。


1. 标题 (Headings)

Markdown 支持六级标题,通过在文本行首加入不同数量的 # 来定义。一级标题最大,六级标题最小。

# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
##### 五级标题 (H5)
###### 六级标题 (H6)

2. 文本基本样式 (Text Styles)

通过简单的符号组合,可以为文本添加常见的修饰效果:

  • 粗体:使用 **文本**__文本__
  • 斜体:使用 *文本*_文本_
  • 删除线:使用 ~~文本~~
  • 行内代码:使用反引号 `代码片段` 包裹

3. 列表 (Lists)

无序列表

使用星号 *、加号 + 或减号 - 作为列表标记,标记后面需跟一个空格:

  • 项目一
  • 项目二
  • 项目三

有序列表

使用数字加英文句点 . 和空格:

  1. 第一步:准备工作
  2. 第二步:编写内容
  3. 第三步:发布分享

4. 引用与分割线 (Blockquotes & Dividers)

引用

在段落前添加大于号 > 可以创建块级引用:

“纸上得来终觉浅,绝知此事要躬行。” —— 陆游

分割线

在一行中输入三个或以上的星号 ***、减号 --- 或下划线 ___ 即可生成一条水平分割线。


5. 链接与图片 (Links & Images)

  • 超链接语法[显示文本](链接地址),例如:访问 GitHub
  • 图片语法![替代文本](图片链接地址)

6. 表格 (Tables)

使用管道符 | 分隔不同的单元格,使用短横线 - 分隔表头与内容,并可以通过冒号 : 控制对齐方式:

语法符号说明描述对齐方式
``单元格分隔符
:---横线靠左左对齐
:---:两侧都有冒号居中对齐
---:横线靠右右对齐

7. 代码块 (Code Blocks)

对于多行代码,可以使用三个反引号 ` 将其包裹,并在首行反引号后指定编程语言名称以实现语法高亮:

# Python 示例代码
def greet(name):
    print(f"Hello, {name}!")

greet("Markdown")

更加进阶的用法可前往

最后修改:2026 年 07 月 21 日
如果觉得我的文章对你有用,请随意赞赏