rst-sample.rst

orphan

ReStructuredText Sample

ReStructuredText is an extensible markup language used by LSST.

ReStructuredText provides basic italic, bold and monospaced typesetting. There is also the concept of roles that provide sophisticated typesetting, such as μ =  − 2.5log₁₀(DN/A) + m₀, and referencing <rst-internal-links>.

Sectioning

Sections are formed with underlining the headline text. We use a conventional sequence of underline symbols <rst-sectioning> to indicate different levels of hierarchy.

Directives

Besides roles that are used for inline markup, reStructuredText has the concept of directives to markup blocks of content. One example is the is the code-block directive:

print('hello world!')