Table of Contents
Md ProHelp Readers Find the Section They Need
Table of Contents reads the H2–H6 headings in a post and turns them into a navigable outline. Place it above the post, in a gutter, or in a sidebar widget.
Screenshots (4)
Nested headings in the left gutter
Table of Contents on the Share page
Table of Contents on the Bookshelf page
Table of Contents in the left gutterThe outline groups H3–H6 headings beneath the H2 before them. Readers can jump to a section, and the current section is highlighted as they scroll.
Choose a top-of-post, left-gutter, or right-gutter placement in Layout settings, or add the MD → Table of Contents widget. Gutter placement requires a Layout without a sidebar or page builder.
An Outline Built from Your Headings
The contents list follows the structure of the post, including nested sections.
Table of Contents reads headings from H2 through H6. H3–H6 headings appear in collapsible sublists beneath the H2 that comes before them.
Click a link to scroll to its heading. The URL hash updates to match, so readers can share a link directly to a section. A link with a heading hash also scrolls to the heading when the page loads.
- Nested H2–H6 outline
- Current section highlighted while scrolling
- Heading links update and follow the URL hash
Choose a Placement That Fits Your Layout
Add the list where it helps readers navigate your articles.
Place it above or beside the post
Choose Top of post, Left gutter, or Right gutter in the post type or single post’s Layout settings. Gutter placements require a Layout with no sidebar and no page builder. Otherwise, the list appears above the post.
Keep a sticky outline in view
At the top of a post, sticky mode collapses the table into a bar that stays on screen and expands when clicked. On screens under 900px, it becomes an expandable bar fixed to the bottom of the screen.
Use the sidebar widget
Add MD → Table of Contents to a widget area and set its title. The widget appears only on single posts and stays hidden when the Layout already adds a table of contents.
Save older posts once
The heading list is read when a post is saved. After installing Table of Contents, save posts written earlier so their heading lists are generated.
Made for Long Articles
H2–H6 headings
Build a contents list from headings in the post.
Nested sections
Group H3–H6 headings under their preceding H2.
Three placements
Top of post, left gutter, or right gutter.
Current section
Highlight the heading the reader is moving through.
Smooth navigation
Scroll to headings and update the URL hash on click.
Sticky bar
Collapse the top placement into a bar that stays in view.
Mobile bar
On narrow screens, use a bottom-fixed expandable bar.
Accessible structure
Use a navigation landmark, ordered list, and expanded-state controls.
Frequently Asked Questions
Which headings appear?
Headings H2–H6 appear. H3–H6 headings are grouped under the H2 that comes before them.
Where can I place the table of contents?
At the top of a post, in the left gutter, or in the right gutter. You can also add it as a sidebar widget on single posts.
Why is it not showing on an older post?
The heading list is generated when a post is saved. Save older posts once after installing the Drop-in.
When do gutter placements fall back to the top?
When the Layout has a sidebar or a page builder. Gutter placements require neither.
What do I need to run it?
Marketers Delight 6.0 or later, WordPress 6.2 or later, and PHP 7.4 or later.