# Table of contents

The table of contents (TOC) is implemented as Markdown list.

A TOC is just a type of Markdown lists. No extended syntax or directive (comment) is needed. The Dice's coefficient

open in new window is mainly used to identify TOCs. This design ensures a clean and natural experience. (v1 README

Multiple TOCs are also allowed. For example, you may want to put one TOC at the beginning of the document, and the other at the end. (#360

# Creating a TOC

Run command "Create Table of Contents" to insert a new TOC.

Update TOCs manually by "Update Table of Contents".

The TOC is automatically updated on file saving by default. You can change the toc.updateOnSave setting to disable it.

The indentation size reuses the list.indentationSize setting. The indentation type (space or tab) of TOC can be configured per file by the "Editor Indentation" in the Status Bar.

Different methods to generate heading ID are supported: VS Code, GitHub, GitLab, and more. Set the slugifyMode setting accordingly.

# Suppressing TOC detection

Add a comment above the list, in case you encounter unexpected TOC recognition. (#525

# Hiding headings from TOC

Multiple usability and reliability issues have been found. This feature needs a thorough revision. Use at your own risk for now.

There are 3 ways to control which headings should not be present in a TOC.

When omitting headings, make sure headings within a document are unique. Duplicate headings may lead to unpredictable behavior.

Add a comment at the end of a heading or above it.
Use the toc.levels setting to only show a range of levels of headings in TOCs.
Use the toc.omittedFromToc setting to omit some headings (and their subheadings) from TOC.

 // In your settings.json "markdown.extension.toc.omittedFromToc":  // Use a path relative to your workspace. "README.md": [ "# Introduction", "## Also omitted" ], // Or an absolute path for standalone files. "/home/foo/Documents/todo-list.md": [ "## Shame list (I'll never do these)" ] > >

1
2
3
4
5
6
7
8
9
10
11
12
13
14

# Section numbering

This feature has non-critical usability issues. We are exploring solutions.