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

如何在Markdown(Myst)中配置Sphinx索引条目?含多条目需求

在Markdown(Myst)中使用Sphinx索引指令的正确方式

关于报错的原因

你之前推测myst_parser有硬编码限制阻止index指令添加内容,这个结论不对。报错Directive 'index': No content permitted的原因是:Myst Parser对代码块形式的指令(如{index})语法要求特殊——所有索引条目必须写在指令的第一行参数中,不能在代码块内部换行添加内容,这和reStructuredText的写法逻辑不同。

单个索引条目的正确写法

正如你找到的方案,单个条目直接写在指令行即可:

```{index} single: execution; context
### 多个索引条目的实现方式
要实现和reStructuredText一样的多索引条目效果,只需把所有条目放在`{index}`指令的参数行中,用**分号分隔**;如果想保持代码可读性,也可以用**反斜杠`\`**换行(Sphinx会忽略反斜杠后的换行,不影响解析)。

对应你给出的reStructuredText示例:

.. index::
single: execution; context
module: main
module: sys
triple: module; search; path

转换为Myst Markdown的写法如下:
或者更易读的换行写法:
module: __main__ \
   module: sys \
   triple: module; search; path
两种写法都会被Sphinx正确解析,生成和reStructuredText完全一致的索引条目。

内容的提问来源于stack exchange,提问作者Igor Brejc
相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.01 08:25:56