在Sphinx中深入理解文档标记语言：reStructuredText详解

# I. 简介

理解文档标记语言

Sphinx简介

reStructuredText简介
## reStructuredText基础

reStructuredText是一种简单且易于阅读的文档标记语言，它是Sphinx文档生成工具的默认标记语言之一。在本章节中，我们将深入探讨reStructuredText的基础知识，包括标题和副标题、列表和注释、以及引用和链接的使用方法。让我们一起来了解reStructuredText的核心概念和基础语法。
### III. 文档结构化

在使用Sphinx编写文档时，了解如何结构化文档内容是非常重要的。本章将介绍如何在reStructuredText中进行文档结构化，包括处理段落和换行、创建列表嵌套以及制作表格的方法。让我们一起深入了解吧。

#### A. 段落和换行

在reStructuredText中，段落通常由一到多行组成，段落之间用空行分隔。换行可以通过在句子末尾加上两个空格来实现，也可以使用“|”符号进行强制换行。

这是第一行。
这是第二行，末尾有两个空格。  
这是第三行，使用“|”符号强制换行。|

#### B. 列表嵌套

reStructuredText支持无序列表和有序列表的嵌套，可以通过缩进的方式来实现。下面是一个列表嵌套的示例：

- 一级无序列表项1
  - 二级无序列表项1
  - 二级无序列表项2
- 一级无序列表项2
  1. 二级有序列表项1
  2. 二级有序列表项2

#### C. 创建表格

表格在文档中是常用的内容展示方式，reStructuredText提供了简洁的语法来创建表格。一个基本的表格由冒号分隔的单元格组成，其中冒号的位置表示对齐方式。

+--------------+------------+
| Header 1     | Header 2   |
+==============+============+
| Row 1, Col 1 | Row 1, Col 2|
+--------------+------------+
| Row 2, Col 1 | Row 2, Col 2|
+--------------+------------+

通过上述介绍，我们可以看到在reStructuredText中如何进行文档结构化。下一章将继续讨论高级格式和样式的内容。
### IV. 高级格式