Markdown链接到Sphinx中的reStructuredText锚点

瓦齐尔

是否有可能以任何方式插入指向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] 删除。

编辑于
0

我来说两句

0条评论
登录后参与评论

相关文章

来自分类Dev

链接到框架中的锚点

来自分类Dev

链接到Rails App中页面上的锚点

来自分类Dev

检测锚点是否链接到ID

来自分类Dev

在 Markdown 中稳健地生成锚点

来自分类Dev

尝试将锚点标签链接到流星js中的div ID

来自分类Dev

将SVG多边形链接到锚点

来自分类Dev

覆盖角度ui-router以链接到页面锚点

来自分类Dev

链接到Laravel页面上的特定锚点

来自分类Dev

第一个锚点链接到#

来自分类Dev

链接到页面中间锚点的 CodeIgniter 控制器

来自分类Dev

链接到锚点 ID 时删除移动菜单

来自分类Dev

链接到不同页面上的锚点和scroolTo使用JQuery锚点

来自分类Dev

内部链接到Sphinx中的自动方法

来自分类Dev

链接到sphinx中的源代码文件

来自分类Dev

内部链接到Sphinx中的自动方法

来自分类Dev

jQuery平滑滚动,用于链接到1个锚点的许多链接

来自分类Dev

WooCommerce类别小部件中的锚点链接

来自分类Dev

在R Shiny中设置相对链接/锚点

来自分类Dev

如何在React中偏移链接和锚点?

来自分类Dev

链接未引用锚点

来自分类Dev

jQuery-将元素滚动到屏幕中间,而不是通过锚点链接到顶部

来自分类Dev

重组文本链接到其他rst文件菜单的锚点

来自分类Dev

链接到页面锚点时,如何在其中调用JS代码?

来自分类Dev

HTML-链接到锚点,而页面不跳到顶部

来自分类Dev

链接到同一页面上的锚点减去一些像素

来自分类Dev

Sphinx中的reStructuredText:引用节时显示数字

来自分类Dev

带锚点的文档之间的链接

来自分类Dev

在链接 codeigniter 中使用锚点

来自分类Dev

rails-链接到同一页面但具有锚点->不重新加载