Supplyist TOC Block
·
A simple Gutenberg block that automatically generates a nested table of contents from post headings.
Add the Table of Contents Block anywhere in your Gutenberg editor. It scans H2–H6 headings in the post content and builds a nested, clickable table of contents. Links automatically work by adding IDs to headings.
No configuration needed. Works on single posts and pages (not archives or category listings).
- No theme editing required You can activate the plugin on any site.
- Compatible with Gutenberg / Classic Editor It processes the final rendered HTML.
- SEO-friendly IDs are based on sanitize_title(), the same function WP uses for slugs.
- Works with headings that already have IDs It does not overwrite existing IDs.
Example: – Structure Your Content – Write your post or page using semantic headings (H2, H3, etc.)—just like you normally would. – Insert the Table of Contents Block – Add the “Table of Contents Block” anywhere in your editor (e.g., right after the introduction). – Let It Work Automatically – The plugin scans your headings, builds a hierarchical, scroll-linked table of contents in real time, and updates dynamically as you edit.
Key Features
- Server-side generated Table of Contents
- Automatically detects H2–H6 headings
- Generates nested lists based on heading hierarchy
- Automatically adds IDs to headings when missing
- Lightweight and simple
- Useful for:
- Adding a Table of Contents to a post or page
- Generating heading IDs
- Linking to sections within content
Why use this plugin?
- Smart Parsing: Supports H2 through H6 headings
- Clean Output: Uses standard HTML lists for maximum theme compatibility
- Non-intrusive: Does not modify existing heading IDs
- Lightweight & Fast