Twelve Springs is a demo website

This simple website showcases the blogging and web design features of the free MD WordPress Theme and Drop-ins. No code was used to publish this website.
Skip to content

Table of Contents: Left gutter

This post exists to show one Table of Contents placement. Every post in this set uses these same headings, so only the placement changes. Scroll down to see how the contents follow along.

Why long posts need a map

A long post asks for a reader’s patience. A table of contents gives some of it back: it shows what’s coming, lets people skip to the part they came for, and marks their place as they read.

What gets listed

The contents are built from the post’s headings. Second-level headings become the main entries, and the headings below them are grouped underneath and open as you reach their section.

What stays out

Headings that live outside the post’s own content, such as widget titles, aren’t included, so the list only ever describes the article itself.

Choosing a placement

The right placement depends on the layout around the post. A sidebar competes for space with a gutter, and a narrow column leaves little room beside the text.

With a sidebar

When the post has a sidebar, the contents sit at the top of the post, or in the sidebar as a widget. The sticky option turns the top version into a bar that stays in view while scrolling.

Without a sidebar

When the sidebar is removed, the empty space beside the text can hold the contents instead. The left and right gutters keep the list visible for the whole read without taking width from the words.

Keeping readers oriented

Whichever placement you choose, the entry for the section on screen is highlighted as you scroll, and clicking an entry jumps straight to its heading.

Long sections

Very long sections keep their entry active the whole way through, so a reader always knows where they are, even between headings.

Short posts

A post with fewer than two headings doesn’t show a table of contents at all, because there’s nothing to navigate between.

The same setting everywhere

Placement can be set for a single post, a category, or a whole post type. A section can default to the left gutter while one post with a sidebar falls back to the top of the post.

Under the hood

This post is a plain demo of one setting: Table of Contents → Left gutter. The text and image are the same on every post in the set, so only the setting changes.

How it’s set up