reStructuredText Document¶
🌐 AI ReaderRead this document in English or ask questions: Open in Claude, ChatGPT, or Gemini ↗
Old documents need no migration. A reST document keeps its doc_id in the field list at the very top of the file (Sphinx calls it docinfo).
Linking to MyST documents¶
A whole document: MyST Markdown Basics
A section: Cross-File Links
Custom text: a document four levels deep
mermaid¶
flowchart TD
rst[README.rst] --> sphinx[Sphinx]
md[README.md] --> sphinx
sphinx-design¶
reST card A
Content A
reST card B
Content B