reStructuredText 文档

旧文档不用迁移。reST 的 doc_id 写在文件开头的 field list 里 (Sphinx 叫它 docinfo)。

引用 MyST 文档

• 整篇文档: MyST Markdown 基础

• 某个小节: 跨文件引用

• 自定义文字: 四级目录下的文档

mermaid

        flowchart TD
    rst[README.rst] --> sphinx[Sphinx]
    md[README.md] --> sphinx
    

sphinx-design

reST 卡片 A

内容 A

reST 卡片 B

内容 B