reStructuredText and Sphinx Reference

Example based gentle reference of the reStructuredText and Sphinx syntax, directives, roles and common issues. It demonstrates almost all the markup making it also good for testing Sphinx themes. Free and open-source.

Table of Contents

Collections

Admonitions
Body elements
Images
Inline elements
Document parts
Sphinx additions

Elements

admonition
attention
caution
contents
danger
emphasis
error
figure
hint
image
important
inline image
inline literal
note
rubric
section
seealso
sidebar
strong emphasis
subscript
superscript
tip
toctree
topic
transition
warning

toctree example¶

This page shows basic toctree directive usage.

Welcome to tourist guide!
- 1. Europe
  - 1.1. Czech
  - 1.2. Germany
- Asia
  - Japan
  - South Korea

Note

Because toctree in europe document sets :numbered:, Europe and bellow sections are numbered.