
_START_ARTICLE_
ReStructuredText
_START_SECTION_
历史
_START_PARAGRAPH_
早期的轻量级标记语言StructuredText（由 Zope 开发）存在许多问题，reST 就是为了解决这些问题而开发的。选择了reStructuredText 这个名称是为了表明reST 是一个“经过修改、重写和重新解释的结构化文本”。_NEWLINE_reST 在 2002 年开始在Python 社区中得到了重要的应用。
_START_SECTION_
参考实现
_START_PARAGRAPH_
reST 解析器的引用实现是Python 编程语言中的Docutils 文本处理框架的一个组件，但是还可以使用其他解析器。_NEWLINE_没有正式的mime 类型注册为reStructuredText，但非官方的是``text/x-rst``。
_START_SECTION_
应用程序
_START_PARAGRAPH_
reStructuredText 通常用于技术文档，例如 Python 库的文档。然而，它也适用于广泛的文本。_NEWLINE_自 2008 年以来，reST 一直是Python 的 Sphinx 文档生成系统的核心组件。_NEWLINE_Trac 也支持reStructuredText，GitHub 和 Bitbucket 也是如此。_NEWLINE_为古登堡计划准备文本的分布式校对器正在考虑采用reST 作为一种基本格式，其他电子书格式可以从这种格式生成。_NEWLINE_2016 年 7 月，Linux 内核项目决定从基于DocBook 的文档过渡到reStructuredText 和 Sphinx 工具链。_NEWLINE_在 3.0 版本中，软件构建工具CMake 从自定义标记语言转换为reStructuredText。
_START_SECTION_
标题
_START_PARAGRAPH_
节标题==============_NEWLINE__NEWLINE_小节标题------------------
_START_SECTION_
列表
_START_PARAGRAPH_
- A bullet list item_NEWLINE_- Second item_NEWLINE__NEWLINE_  - A sub item_NEWLINE__NEWLINE_- Spacing between items creates separate lists_NEWLINE__NEWLINE_- Third item_NEWLINE__NEWLINE_1) An enumerated list item_NEWLINE__NEWLINE_2) Second item_NEWLINE__NEWLINE_   a) Sub item that goes on at length and thus needs_NEWLINE_      to be wrapped. Note the indentation that must_NEWLINE_      match the beginning of the text, not the _NEWLINE_      enumerator._NEWLINE__NEWLINE_      i) List items can even include_NEWLINE__NEWLINE_         paragraph breaks._NEWLINE__NEWLINE_3) Third item_NEWLINE__NEWLINE_#) Another enumerated list item_NEWLINE__NEWLINE_#) Second item
_START_SECTION_
图片
_START_PARAGRAPH_
.. image:: /path/to/image.jpg
_START_SECTION_
指定链接
_START_PARAGRAPH_
A sentence with links to `Wikipedia`_ and the `Linux kernel archive`_._NEWLINE__NEWLINE_.. _Wikipedia: https://www.wikipedia.org/_NEWLINE_.. _Linux kernel archive: https://www.kernel.org/
_START_SECTION_
匿名链接
_START_PARAGRAPH_
Another sentence with an `anonymous link to the Python website`__._NEWLINE__NEWLINE___ https://www.python.org/_NEWLINE_N.B.: 指定链接和匿名链接用重字符(`)括起来，而不是用引号(')括起来。
_START_SECTION_
文字块
_START_PARAGRAPH_
::  some literal text_NEWLINE__NEWLINE_This may also be used inline at the end of a paragraph, like so::  some more literal text.. code:: python_NEWLINE__NEWLINE_   print("A literal block directive explicitly marked as python code")