`[[toc]]` does not include headings inside `:::details` blocks, while "On this page" sidebar works correctly | `[[toc]]` 无法识别 `:::details` 块内的标题，但侧边栏“本页结构”正常显示

[gforoosge]

Describe the bug

When using [[toc]] to generate a table of contents in VitePress, headings (e.g., ## Heading) placed inside a :::details custom container are missing from the generated TOC list. However, the "On this page" sidebar on the right side correctly includes those headings.

在 VitePress 中使用 [[toc]] 生成页面目录时，发现如果某个标题（如 ## 标题）被包裹在 :::details 自定义容器内，则该标题不会出现在由 [[toc]] 生成的目录列表中。然而，页面右侧的“On this page”（本页结构）侧边栏却能正确包含该标题

# VitePress 💙 StackBlitz

[[toc]]

## foo

123

:::details

## bar

345

:::

Reproduction

https://stackblitz.com/edit/vite-w37rq9sf?file=docs%2Fexample.md

1. Place [[toc]] in a Markdown file.
2. Put a heading inside a :::details block, e.g.:

   :::details Click to expand
   ## Wrapped heading
   :::

3. Build or preview the page and compare the TOC generated by [[toc]] with the right sidebar.

---

1. 在 Markdown 文件中使用 [[toc]]
2. 在 :::details 块内放置一个标题，例如：

   :::details 点击展开
   ## 被包裹的标题
   :::

3. 构建或预览页面，查看 [[toc]] 生成的目录和右侧侧边栏的差异

Expected behavior

[[toc]] should use the same heading extraction logic as the "On this page" sidebar, so it should also include headings inside details blocks.

[[toc]] 应与“On this page”侧边栏保持一致的标题提取逻辑，即同样包含 details 块内的标题

System Info

Vitepress: Latest (alpha.17 and .19)
OS: Windows 11 25H11

Additional context

Not sure if it was done on purpose

不确定是不是有意而为之

🤔

Validations

• Check if you're on the latest VitePress version.
• Follow our Code of Conduct
• Read the docs.
• Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.

[brc-dd]

The "On this page" thing is created on client side, while [[toc]] is generated using top level markdown headings. I don't think [[toc]] can handle all the cases like nesting or headings added via the vue component. Manually create a list of links for now if you want such behavior.

[brc-dd]

Ah sorry, this specific behavior is supported btw:

Add this to your config:

  markdown: {
    toc: {
      shouldAllowNested: true,
    },
  },

https://stackblitz.com/edit/vite-1azujdqa?file=docs%2F.vitepress%2Fconfig.ts

See https://github.com/mdit-vue/mdit-vue/tree/main/packages/plugin-toc#options