1. 引言

OpenAPI规范（前Swagger规范）标准化了REST API文档语言，并且是平台无关的。我们可以以YAML或JSON格式创建OpenAPI文档。

另一方面，Swagger是一系列用于实现和使用该标准的工具集合。有些是免费的，有些是开源的，有些是商业的。这些工具帮助我们设计、文档化和使用REST API。

在本文中，我们将学习如何格式化OpenAPI文档中的文本描述。

2. OpenAPI编辑器

有几种工具支持我们创建OpenAPI文档。一些流行的工具包括：