.. _rst-overview:

Sphinx 基础
=====================

.. note::

    reStructuredText（reST）是Docutils和Sphinx使用的默认纯文本标记语言。Docutils提供了基本的reStructuredText语法，而Sphinx扩展了它以支持其他功能。

    本章主要介绍了reST语法中最常用的部分，更多细节内容，可以参考Sphinx源站:

    - [#]_ RestructureText Index
    - [#]_ reStructuredText Primer
    - [#]_ reStructuredText Directives
    - [#]_ Sphinx 主题

.. toctree::
    :caption: Table of Contents
    :maxdepth: 2
    :numbered:

    try
    admonition
    RestructureText Index <http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>

----

.. [#] RestructureText Index: http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html
.. [#] RestructureText Primer： http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
.. [#] RestructureText Directives： http://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html
.. [#] Sphinx 主题： https://sphinx-themes.org/