Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Table of Contents

hipstersmoothiehipstersmoothie214k downloads

Create a table of contents for a note.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates21

Create a table of contents for a note.

Example of content creation

Features

This plugin exposes the following commands:

Action Hotkey
Create full table of contents Blank by default
Create table of contents for next heading level Blank by default

And the following settings:

Setting type Default
List Style 'bullet' or 'number' 'bullet'
Title 'string' undefined'
Minimum header depth number 2
Maximum header depth number 6

Usage

This plugin will create a table of content for the sub-heading of the current heading level.

Example:

Input: Run "Table of Contents" under a level 2 heading
Output: "Table of Contents" only contains subheadings of that level 2 heading

Installing

Either install the latest release from Obsidian directly or unzip the latest release into your <vault>/.obsidian/plugins/ folder.

Once the plugin is installed, you need to make sure that the switch for "Table of Contents" is turned on. After you are all setup you would see this plugins commands in the command palette (CMD + P). You can assign the commands to hotkeys for easy usage.

Here is my setup:

  • Create full table of contents => CMD + SHIFT + T
  • Create table of contents for next heading level => CMD + T

Customizations

Detailed Nested Ordered Lists

If you want the table of contents to use nested list counting (ex: 1.1, 1.2) add the following CSS snippet to obsidian. This will effect all ordered lists in your notes.

ol {
  counter-reset: item;
}

ol li {
  display: block;
}

ol li:before {
  content: counters(item, ".") ". ";
  counter-increment: item;
  padding-right: 5px;
}

NOTE: Make sure you enable the snippet in obsidian's options.

HealthFair
ReviewCaution
About
Create a table of contents for a note as a linked list of headings, either full or limited to the next heading level. Choose list style, title and header-depth range to control scope.
NavigationLinksMarkdown
Details
Current version
0.2.0
Last updated
3 years ago
Created
5 years ago
Updates
21 releases
Downloads
214k
Compatible with
Obsidian 0.10.12+
Platforms
Desktop, Mobile
Report bugRequest featureReport plugin
Author
hipstersmoothiehipstersmoothie
twitter.com/hipstersmoothie
GitHubhipstersmoothie
  1. Community
  2. Plugins
  3. Navigation
  4. Table of Contents

Related plugins

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Consistent Attachments and Links

Move note attachments and update links automatically.

Auto Link Title

Automatically fetches the titles of links from the web.

Strange New Worlds

Reveal networked thought and the strange new worlds created by your vault.

Link Embed

Convert URLs in your notes into embeded previews.

Notebook Navigator

A better file browser and calendar inspired by Apple Notes, Bear, Evernote and Day One.

Importer

Convert your data to Markdown files you can use in Obsidian. Works with Apple Notes, OneNote, Evernote, Notion, Google Keep, and many other formats.

Recent Files

Display a list of recently opened files.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Homepage

Open a note, base, or workspace on startup, or set it for quick access later.