Welcome to the reStructuredText Primer!

The reStructuredText Primer serves two purposes. First, it is a project by which I can learn reStructuredText and, to a lesser extent, Sphinx and Docutils. Second, it is a resource for others to learn the basics of reStructuredText.

My primary resources are:

• reStructuredText Markup Specification

• Sphinx documentation

• Online reStructuredText Editor

Contents:

• Sections
• Blocks
  • Paragraphs
  • Literal blocks
  • Line Blocks
  • Transitions
• Inline Markup
  • Escaping characters
• Hyperlinks
  • External links
  • Internal links
• Footnotes and Citations
  • Footnotes
  • Citations
• Lists
  • Bulleted lists
  • Enumerated lists
  • Definition lists
• Tables
  • Simple tables
  • Grid tables
• Images and Figures
  • Image directive
  • Figure directive
• Admonitions
  • Generic admonitions