如何解决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 举报,一经查实,本站将立刻删除。