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>引用链接
将链接定义放在文档末尾:
markdown
这是一个[引用链接示例][ref]。
[ref]: https://example.com "示例网站"1.6 图片
图片语法与链接类似,前面加一个 !:
markdown

替代文本(alt text)对于可访问性非常重要,应简洁描述图片内容。
1.7 转义字符
使用反斜杠 \ 转义 Markdown 特殊字符:
markdown
\* 这不是斜体 \*
\# 这不是标题 \#
\` 这不是代码 \`常用需要转义的字符:\ * _ { } [ ] ( ) # + - . ! |
练习
- 创建一个包含三级标题、段落、粗体、斜体的文档
- 编写一个包含无序列表和有序列表的清单
- 插入一个链接和一张图片(使用占位图 URL)
上一篇: 无(本章节为教程起点)
下一篇: 2. 进阶格式与语法