.. include:: /Includes.rst.txt .. highlight:: rst .. index:: reStructuredText reST .. _Formatting-with-reST: .. _format-sphinx: .. _rest-quick-start: ================ reStructuredText ================ This chapter is an introduction and reference for writing documentation using reStructuredText (also referred to as reST). It is recommended to read (or at least browse through) the :ref:`writing-rest-introduction` and the general :ref:`format-rest-cgl` first. Or, use the :ref:`rest-cheat-sheet`, which contains the most commonly used markup on one page. We cannot cover every reST markup that is available. For more information, see other resources, such as: * `reSTructuredText reference by Sphinx `__ * `reSTructuredText introduction on docutils `__ * `reStructuredText Markup Specification `__ .. toctree:: :hidden: Introduction BasicRestSyntax CheatSheet Reference/Index