微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

Markdown链接到Sphinx中的reStructuredText锚点

如何解决Markdown链接到Sphinx中的reStructuredText锚点

是否可以通过任何方式插入指向Markdown文件链接,该链接指向reStructuredText文件中的锚点?

我有一个项目文档,其中也包含.rst和.md文件,并且我使用的是m2rr Sphinx扩展名,但是它似乎仅支持文件内第一个链接

有什么办法可以做到这一点?

解决方法

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

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

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

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

目标标头使用以下语法定义:

(header_target)=

然后可以使用ref内联角色引用它们:

{ref}`header_target`

默认情况下,引用将使用目标的文本(例如节标题),但是您也可以直接指定文本:

{ref}`my text <header_target>`

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。