.. comment Sample RST file for testing — SampleFiles.online
.. reStructuredText (RST) is used by Sphinx and Python docs.

=================================
Sample reStructuredText Document
=================================

This is a sample **RST** (reStructuredText) file for testing parsers,
documentation pipelines, and Sphinx builds.

Heading levels
==============

Level 2 heading
---------------

Level 3 heading
~~~~~~~~~~~~~~~

Paragraphs are separated by blank lines. *Emphasis*, **strong emphasis**,
and ``inline literals`` are common inline markup.

Lists
-----

* Unordered item one
* Unordered item two
* Unordered item three

1. Ordered item
2. Another ordered item

Definition lists
   A term followed by an indented definition.

Code blocks
-----------

.. code:: python

   def greet(name: str) -> str:
       """Return a greeting."""
       return f"Hello, {name}!"

Tables
------

=====  =====  =====
Col A  Col B  Col C
=====  =====  =====
1      2      3
4      5      6
=====  =====  =====

Links
-----

`Python documentation <https://docs.python.org>`_ uses RST.

Directives and roles like :code:`print()` round out the syntax.