:doc_id: OAFSttVJviBK
:description: 说明旧的 reStructuredText 文档如何和 MyST 文档共存并互相引用。是一篇 reST 兼容性演示文档。

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

引用 MyST 文档
------------------------------------------------------------------------------
- 整篇文档: :ref:`bhNtpbPvxMCO`
- 某个小节: :ref:`bhNtpbPvxMCO-cross-ref`
- 自定义文字: :ref:`四级目录下的文档 <tPLKDkIdEbXW>`

mermaid
------------------------------------------------------------------------------
.. mermaid::

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

sphinx-design
------------------------------------------------------------------------------
.. grid:: 2

    .. grid-item-card:: reST 卡片 A

        内容 A

    .. grid-item-card:: reST 卡片 B

        内容 B