fix: exclude headings inside blockquotes from sidebar TOC

[Bowl42]

Summary

• Issue: Headings inside blockquotes (e.g. > # Title) are incorrectly added to the sidebar table of contents. They should only render as headings within the blockquote content, not appear as navigation items.
• Root cause: The heading compiler (heading.js) unconditionally pushes every heading to compiler.toc, with no awareness of whether it's inside a blockquote. When the blockquote compiler (blockquote.js) calls this.parser.parse(tokens), any headings within are processed and added to the TOC.
• Fix: Introduce a blockquoteDepth counter on the compiler instance. The blockquote compiler increments it before parsing child tokens and decrements it in a finally block. The heading compiler checks this counter and skips TOC insertion when depth > 0. A counter (rather than a boolean flag) correctly handles nested blockquotes.

Changes

src/core/render/compiler.js

• Initialize this.blockquoteDepth = 0 in the Compiler constructor
• Pass compiler: this to blockquoteCompiler() so it can access the compiler instance

src/core/render/compiler/blockquote.js

• Accept compiler from the options parameter
• Increment compiler.blockquoteDepth before parsing child tokens
• Decrement in a finally block to ensure cleanup even if parsing throws

src/core/render/compiler/heading.js

• Wrap compiler.toc.push(nextToc) in a check: only push when !compiler.blockquoteDepth
• Headings inside blockquotes are still rendered in the page content — they just won't appear in the sidebar

Test plan

• Create a page with a heading inside a blockquote: > # Quoted Title
• Verify the heading renders correctly inside the blockquote in the main content
• Verify the heading does NOT appear in the sidebar TOC
• Verify normal headings (outside blockquotes) still appear in the sidebar TOC
• Verify nested blockquotes (> > # Nested) also exclude headings from TOC
• Verify callout blockquotes (> [!NOTE]) with headings also exclude those headings from TOC

Fixes #1951

🤖 Generated with Claude Code

[vercel]

@Bowl42 is attempting to deploy a commit to the Docsify Team on Vercel.

A member of the Team first needs to authorize it.