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.

[Copilot]

Pull request overview

This PR updates the markdown rendering pipeline to prevent headings rendered inside blockquotes from being added to the compiler-generated table of contents (TOC), likely to avoid polluting sidebar/subsidebar navigation with headings from callout blocks.

Changes:

• Track blockquote nesting depth on the Compiler instance (blockquoteDepth).
• Increment/decrement blockquoteDepth while parsing renderer.blockquote tokens.
• Gate TOC insertion in headingCompiler so headings are only added when not inside a blockquote.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
src/core/render/compiler/heading.js	Skips pushing heading entries into compiler.toc when inside a blockquote.
src/core/render/compiler/blockquote.js	Adds depth tracking around blockquote parsing to support TOC suppression.
src/core/render/compiler.js	Initializes blockquoteDepth and passes compiler into blockquoteCompiler.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

[sy-records]

Thanks for your PR.

This can be placed on this instead of being imported into the compiler.

[sy-records]

Suggested change

	compiler.blockquoteDepth++;
	try {
	const body = this.parser.parse(tokens);
	return `${openTag}${body}${closeTag}`;
	} finally {
	compiler.blockquoteDepth--;
	}
	this.__docsifyBlockquoteDepth = (this.__docsifyBlockquoteDepth || 0) + 1;
	let body;
	try {
	body = this.parser.parse(tokens);
	} finally {
	this.__docsifyBlockquoteDepth = Math.max(0, this._blockquoteDepth - 1);
	}

[sy-records]

Suggested change

	if (!compiler.blockquoteDepth) {
	compiler.toc.push(nextToc);
	}
	if (!this.__docsifyBlockquoteDepth || this.__docsifyBlockquoteDepth === 0) {
	compiler.toc.push(nextToc);
	}