Skip to content

1. Markdown 基础语法

"简洁的语法,强大的表达力。"

Markdown 是一种轻量级标记语言,使用易读易写的纯文本格式编写文档。它由 John Gruber 和 Aaron Swartz 于 2004 年创建,现已成为技术社区最流行的文档编写方式之一。

1.1 标题

标题用于组织文档结构,分为 6 个级别:

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

渲染效果:

一级标题(H1)

二级标题(H2)

三级标题(H3)

四级标题(H4)

五级标题(H5)
六级标题(H6)

注意

  • 一级标题通常用于文档主标题,一个文档只使用一个
  • 标题前使用 #,后跟一个空格
  • 避免跳级使用标题(如从 H2 直接到 H4)

1.2 段落与换行

段落是 Markdown 文档的基本单位。段落之间用空行分隔:

markdown
这是第一段。Markdown 会自动处理段间距,使文档更易读。

这是第二段。两个段落之间必须有一个空行,否则会被视为同一段落。

换行:在行尾使用两个空格加回车,或者使用空行分隔段落。大多数 Markdown 解析器支持直接回车换行。

1.3 强调

粗体

使用 **__ 包裹文本:

markdown
这是 **粗体** 文本。
这是 __粗体__ 文本。

渲染:这是 粗体 文本。

斜体

使用 *_ 包裹文本:

markdown
这是 *斜体* 文本。
这是 _斜体_ 文本。

渲染:这是 斜体 文本。

粗斜体

同时使用两种标记:

markdown
这是 ***粗斜体*** 文本。

渲染:这是 粗斜体 文本。

删除线

使用 ~~ 包裹文本(GFM 扩展):

markdown
这是 ~~删除线~~ 文本。

渲染:这是 删除线 文本。

1.4 列表

无序列表

使用 -*+ 开头,后跟空格:

markdown
- 项目一
- 项目二
  - 子项目二.1
  - 子项目二.2
- 项目三

渲染:

  • 项目一
  • 项目二
    • 子项目二.1
    • 子项目二.2
  • 项目三

嵌套:通过缩进(通常 2 或 4 个空格)创建子列表。

有序列表

使用数字加点开头:

markdown
1. 第一步
2. 第二步
   1. 子步骤二.1
   2. 子步骤二.2
3. 第三步

注意:有序列表的数字可以是乱序的,Markdown 会自动重新编号。

1.5 链接

基本链接

markdown
[链接文字](URL "可选标题")

示例:

markdown
[Network101 首页](/)
[GitHub](https://github.com "访问 GitHub")

渲染:

自动链接

对于纯 URL,可以使用尖括号自动创建链接:

markdown
<https://example.com>

渲染:https://example.com

引用链接

将链接定义放在文档末尾:

markdown
这是一个[引用链接示例][ref]。

[ref]: https://example.com "示例网站"

1.6 图片

图片语法与链接类似,前面加一个 !

markdown
![替代文本](图片URL "可选标题")
![Network101 Logo](/logo.svg)

替代文本(alt text)对于可访问性非常重要,应简洁描述图片内容。

1.7 转义字符

使用反斜杠 \ 转义 Markdown 特殊字符:

markdown
\* 这不是斜体 \*
\# 这不是标题 \#
\` 这不是代码 \`

常用需要转义的字符:\ * _ { } [ ] ( ) # + - . ! |


练习

  1. 创建一个包含三级标题、段落、粗体、斜体的文档
  2. 编写一个包含无序列表和有序列表的清单
  3. 插入一个链接和一张图片(使用占位图 URL)

上一篇: 无(本章节为教程起点)
下一篇: 2. 进阶格式与语法