You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Sphinx Myst中跨文档链接至脚注?

跨Myst文档链接脚注的问题
  • 我正在用Sphinx + Read the Docs主题 + Myst编写项目文档,想要实现跨Myst文件链接脚注,期望能用类似以下的语法:

    See {ref}`Footnote %s <example.md/footnote-label>` in the {ref}`examples` page.
    

    最好能自动把footnote-label替换成对应的脚注编号,退一步说,只要能给脚注添加可被链接的锚点也行。

  • 目前跨文档链接章节标题、自定义锚点、公式、图表等都能正常工作,同一Myst文件内的脚注使用也没有问题,文档最终以HTML格式渲染。

  • 我没在Myst的官方文档里找到对应的实现方法,虽然可以通过硬编码渲染后的HTML文件路径来实现链接:

    [this footnote](document-base/example.html#footnote-label) 
    

    但更希望能通过某种方式让Sphinx/Myst自动解析这类引用,不用手动维护路径。


编辑补充:
按照建议给脚注添加自定义标签后,代码如下:

I am writing a paragraph that requires a footnote.[^the-footnote]

(my-footnote)=
[^the-footnote]: This is what a footnote looks like.

More stuff...

使用{ref}my-footnote``进行链接时,跳转的位置是More stuff...之前的段落末尾,而不是页面底部实际显示脚注内容的位置。


内容的提问来源于stack exchange,提问作者William Seligman

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.30 15:48:30