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

Intro

reStructuredText overview
Directives and roles
Sphinx and Docutils
Tools and editors

Collections

Admonitions
Body elements
Code examples
Images
Inline elements
Lists
Document parts
Semantic elements
Sphinx additions

Elements

admonition
attention
caution
code-block
contents
danger
emphasis
enumerated-list
error
figure
file
hint
image
important
inline image
inline literal
literal-block
note
paragraph
parsed-literal-block
rubric
section
seealso
sidebar
strong emphasis
subscript
substitution
superscript
tip
toctree
topic
transition
warning

Etc.

Contributing

Hidden toctree example¶

This page shows toctree directive with :hidden: option, i.e. except document title and this paragraph, the page will be empty.