瓦齐尔
是否有可能以任何方式插入指向Markdown文件的链接,该链接指向reStructuredText文件中的锚点?
我有一个项目文档,其中也包含.rst和.md文件,并且我正在使用m2rr Sphinx扩展名,但是它似乎仅支持文件内第一个锚链接。
有什么办法可以做到这一点?
史蒂夫·皮尔西
Markdown本身不支持交叉引用文档中的任意位置。
一种解决方法是插入基于HTML的锚。
[My Label](/root-relative-url.html#anchor-in-page)
另一种选择是使用MyST。在这里,您将使用MyST语法或嵌入reST语法,而不是将markdown用于锚点。
目标标头使用以下语法定义:
(header_target)=
然后可以使用ref inline角色来引用它们:
{ref}`header_target`
默认情况下,引用将使用目标的文本(例如节标题),但是您也可以直接指定文本:
{ref}`my text <header_target>`
本文收集自互联网,转载请注明来源。
如有侵权,请联系[email protected] 删除。
编辑于
我来说两句