python - Markdown 链接到 Sphinx 中的 reStructuredText anchor

Question

是否有可能以任何方式插入指向 reStructuredText 文件中 anchor 的 Markdown 文件的链接？

我有一个包含 .rst 和 .md 文件的项目文档，我正在使用 m2rr Sphinx 扩展，但它似乎只支持文件内第一个 anchor 链接。

有什么办法可以实现吗？

Answer 1

Markdown 本身不支持交叉引用跨文档的任意位置。

一种解决方法是插入基于 HTML 的 anchor 。

[My Label](/root-relative-url.html#anchor-in-page)

另一种选择是使用 MyST .在这里，您将不使用 markdown 作为 anchor ，而是使用 MyST syntax或嵌入 reST 语法。

Target headers are defined with this syntax:

(header_target)=

They can then be referred to with the ref inline role:

{ref}`header_target`

By default, the reference will use the text of the target (such as the section title), but also you can directly specify the text:

{ref}`my text <header_target>`