---
title: "Table of contents note"
description: "A note in your folder that links every saved chat, grouped by service, project and month. How to turn it on, rename it, write in it and open it in Obsidian."
url: https://chattomarkdown.com/docs/table-of-contents/
version: "1.0.5"
updated: 2026-11-04
---

# Table of contents note

> Turn on Settings → Obsidian → Table of contents and the extension keeps one note in your folder that links every saved chat, grouped by service, project and month. It updates within seconds of each saved chat, keeps anything you write above or below its block, and you can rename it under Note name.

The table of contents is one Markdown note that links every chat you have saved. It is grouped by service, then project, then month, with counts, so you can see your whole archive on one page and click through to any chat. In Obsidian it also makes your chats show up connected in the graph.

It is off by default and free on every plan.

## Turn it on

1. **Open Settings → Obsidian.** Click the extension's icon, then the settings icon, and choose **Obsidian** in the sidebar.
2. **Turn on Table of contents.** It is under **Linked notes**. The extension writes the note at once and shows "Table of contents ready:" with its path.
3. **Check where it is.** Below the switches you see the note's path, a button to copy it, **Open in reader**, and, when your folder is the top of an Obsidian vault, **Open in Obsidian**.

![Settings, Obsidian section with Table of contents on and the Note name row](https://chattomarkdown.com/docs/shots/1.0.5/settings-obsidian-light.webp "Table of contents on, with its name and where it is")

1. **Table of contents** turns the note on or off.
2. **Note name** is the note's file name. Change it here, not in Obsidian.
3. **Open in Obsidian** opens Obsidian.

If Chrome can't open your folder right now (for example after a restart), you see "The table of contents will be made at the next sync". Allow access again from the popup or **Settings → Folder** (see [Choose your folder](https://chattomarkdown.com/docs/folder/)), and it is written the next time a chat is saved. You see the same message if a sync is running; the note then appears within seconds of the next chat that sync saves.

## Where the note is

The note is called `AI Chats index.md` unless you rename it. It sits at the top of your chats:

- With a **Subfolder** set in **Settings → Folders and filters** (for example `AI Chats`), it is in that subfolder: `AI Chats/AI Chats index.md`.
- With no subfolder, it is at the top of the folder you chose.

```tree
Obsidian Vault/
  AI Chats/
    AI Chats index.md
    ChatGPT/
      Travel/
        2026-10-17 Lisbon food trip.md
    Claude/
      2026-10-20 Postgres index tuning.md
```

When you change the subfolder, the note moves into the new subfolder with everything you wrote in it.

## What it lists

The note starts with a total and a count per service. Then each service has a section, each project inside it a section, and each month a list of chats, newest first. Here is a real example:

```markdown
<!-- chattomarkdown:index:start · updated automatically on sync; write your own notes above or below this block -->
# AI chats

4 chats · ChatGPT 3 · Claude 1

## ChatGPT · 3 chats

### Work · 1 chat

#### October 2026 · 1

- [[AI Chats/ChatGPT/Work/2026-10-21 Quarterly OKR draft|Quarterly OKR draft]]

### Other chats · 2 chats

#### October 2026 · 1

- [[AI Chats/ChatGPT/2026-10-17 Lisbon food trip|Lisbon food trip]]

#### September 2026 · 1

- [[AI Chats/ChatGPT/2026-09-30 Sourdough starter schedule|Sourdough starter schedule]]

## Claude · 1 chat

### October 2026 · 1

- [[AI Chats/Claude/2026-10-20 Postgres index tuning|Postgres index tuning]]
<!-- chattomarkdown:index:end -->
```

How it is grouped:

- **Services** each get a `##` heading with their number of chats.
- **Projects** (ChatGPT and Claude Projects, Perplexity Spaces) each get a `###` heading, in alphabetical order. Chats that aren't in a project come last, under **Other chats**. A service with no projects goes straight to its months.
- **Months** are the month the chat was started, newest month first. A chat without a start date is listed by the date it was last updated.
- **Chats** are links to the notes, with the chat's title as the link text. Chats deleted on their site that you keep are marked "· deleted".
- With **Hide secrets** on (**Settings → What to save**), keys and passwords in titles are masked here too.

The links use the full path from your folder, so they work in Obsidian and in any Markdown app that reads wiki links.

## When it updates

The extension rewrites the list within seconds of each saved chat, whether the chat was saved by auto-save, a sync, the **Save** button, or when you left the chat. During a long first sync of your history, the note grows as the chats come in. It is also written when you turn it on, rename it, and after **Apply to saved files** in **Settings → File names**. Chats you [import](https://chattomarkdown.com/docs/import/) from a data export are added at the end of the next sync.

If nothing changed, the file isn't touched, so a sync service has nothing to upload.

> [!NOTE]
> In version 1.0.0 the note was rewritten only when a sync finished (or when you saved one chat by itself). From 1.0.1 it keeps up during a sync.

## Write your own notes in it

The list sits between two HTML comments, `chattomarkdown:index:start` and `chattomarkdown:index:end`. Only the text between them is rewritten. Anything you write above or below the block stays, every time. For example, add a short intro at the top, or a list of your favourite chats at the bottom.

> [!WARNING]
> If you delete either marker comment, the extension stops updating the note and leaves it exactly as it is. When you turn the table of contents on, it then says "Table of contents left as it is: its start and end markers were removed". To get an updated list again, delete the note (or rename it) and the extension writes a fresh one at the next save.

## Rename the note

You can give the note any name in **Settings → Obsidian → Note name**. The row shows while **Table of contents** is on.

1. **Click the Note name field and type the new name.** You don't need to type `.md`: it is added for you. **Cancel** and **Rename** appear as soon as the name is different.
2. **Click Rename, or press Enter.** To put the old name back, click **Cancel** or press <kbd>Esc</kbd>.
3. **Check the message.** "Renamed to “…”" means the note has moved. Anything you wrote in it moves with it.

![The Note name field with a new name typed and the Cancel and Rename buttons showing](https://chattomarkdown.com/docs/shots/1.0.5/settings-obsidian-rename-light.webp "Renaming the table of contents note")

Things to know about names:

- Some characters can't be in a file name or an Obsidian link: `/ \ : * ? " < > | # ^ [ ] ~`. They are left out, and the row tells you the name it will use: "It will be named “…”: some characters can’t be in a file name or an Obsidian link."
- A name can be up to 100 characters. An empty name isn't allowed ("Type a name for the note.").
- If a file with that name is already there, the extension refuses rather than write over it: "There’s already a file named “…” there. Choose another name."
- If Chrome can't open your folder right now, the setting changes and you see "Renamed. The note moves to “…” at the next sync".
- Links to the note from your own notes keep the old name. Obsidian updates links only when you rename inside Obsidian, so fix those links by hand.

> [!IMPORTANT]
> Rename the note in Settings, not in Obsidian. If you rename or move it in Obsidian, the extension doesn't know and writes a new note under the name in Settings at the next save. The renamed copy then stops updating.

## Open it

- **Open in reader** shows the table of contents in the extension's reader. You can switch between **Contents** (every chat by service, project and month; click a title to open the chat) and **Markdown** (the note as it is on disk). The reader's table of contents button, at the top of its sidebar, opens the same view.
- **Open in Obsidian** opens the note in Obsidian. It shows when your folder is the top of an Obsidian vault. If the note isn't in your folder yet, the extension writes it first. See [Use with Obsidian](https://chattomarkdown.com/docs/obsidian/#open-in-obsidian) if Obsidian doesn't open.
- The copy button next to the path copies the note's path, for example to paste into an Obsidian link.

## Turn it off

Turn off **Settings → Obsidian → Table of contents**. You see "Table of contents off. The note stays in your folder." The note is no longer updated. Delete it in Obsidian or your file manager if you don't want it.

**Start over** and **Delete all saved chats** remove the list from the note, and the note itself when nothing else is in it (see [Start over or delete saved chats](https://chattomarkdown.com/docs/start-over/)).

## Problems

- **The note isn't there.** Check that **Table of contents** is on and look at the path under it. If Chrome lost access to your folder, allow it again; the note is written at the next save.
- **The list is out of date.** The markers may have been removed (see above), or you renamed the note in Obsidian and are looking at the old copy. Check the path in Settings.
- **A chat is missing.** The list shows chats the extension has saved. Chats skipped by your filters, or not saved yet, are not in it. See [How saving works](https://chattomarkdown.com/docs/how-saving-works/).
- **A link opens an empty new note in Obsidian.** Obsidian creates a new note when it can't find a link's target. The links start from the folder you chose, so if you chose a folder inside your vault rather than the vault itself, choose the vault itself and set a subfolder instead (see [Use with Obsidian](https://chattomarkdown.com/docs/obsidian/#pick-your-vault-as-the-folder)).

## Questions

### Is the table of contents a Pro feature?

No. It works on Free and Pro. On Free it lists the chats you have saved.

### Will it overwrite what I write in the note?

No. Only the block between its two marker comments is rewritten. Text above or below the block stays.

### Can I rename the note in Obsidian?

Rename it in Settings → Obsidian → Note name instead. If you rename it in Obsidian, the extension doesn't know and makes a new note under the name in Settings at the next save.

### Does it need an Obsidian vault?

No. It is a plain Markdown note and works in any folder. Only the Open in Obsidian button needs the folder to be the top of a vault.
