---
title: "How your files are organised"
description: "The folder layout Chat to Markdown creates: service and project folders, an optional subfolder, attachments, hidden version history, and filters to skip chats."
url: https://chattomarkdown.com/docs/1.0.1/folder-structure/
version: "1.0.1"
updated: 2026-11-04
---

# How your files are organised

> Each chat is one .md file. By default it goes into a folder named after its service (ChatGPT, Claude and so on), and into a folder named after its project when it has one. Pictures go into an attachments folder next to the note, and version history into a hidden .chattomarkdown folder. Change this in Settings → Folders and filters.

Every chat becomes one Markdown file. Where that file goes depends on a few settings in **Settings → Folders and filters**. This page shows the full layout, what each setting changes, how to leave chats out, and what happens if you move or rename files yourself.

## The full layout

With the default settings, a folder called **Obsidian Vault** with ChatGPT and Claude chats looks like this:

```tree
Obsidian Vault/
  .chattomarkdown/                        hidden: version history
    history/
      chatgpt/
        68f1c2a0-5b7e-8003-9a41-2c6d0e7f1a93.json
      claude/
        4b1d6a0e-2f3c-4e5d-9a8b-7c6d5e4f3a2b.json
  AI Chats index.md                       only with Table of contents on
  ChatGPT/
    2026-10-22 Quarterly OKR draft.md
    Travel/                               a ChatGPT project
      2026-10-17 Lisbon food trip.md
      attachments/
        market 3f9a1c2e.jpg
  Claude/
    2026-10-20 Sourdough starter schedule.md
    2026-10-25 Postgres index tuning.md
    attachments/
      Feeding schedule 794b3f96.md
```

| Part | What it is |
|---|---|
| Service folder | One per service, named as the service: **ChatGPT**, **Claude**, **Gemini**, **Copilot** (Microsoft Copilot), **Perplexity**, **Grok**, **DeepSeek**, **GitHub Copilot**. |
| Project folder | Chats in a ChatGPT or Claude project, or a Perplexity Space, go into a folder with the project's name, inside the service folder. Grok projects count too. |
| Chat file | `<date> <title>.md` by default, where the date is the day the chat started. See [File names and properties](https://chattomarkdown.com/docs/1.0.1/file-names/). |
| `attachments` | Pictures, uploads and files Claude made, next to the notes that show them. See [Attachments](#attachments). |
| `.chattomarkdown` | Hidden. Holds the version history of each chat. See [The hidden history folder](#the-hidden-history-folder). |
| Table of contents | One note that links every saved chat. Only there when you turn it on. See [Table of contents note](https://chattomarkdown.com/docs/1.0.1/table-of-contents/). |

When two chats would get the same file name in the same folder, the second gets ` (2)` at the end, for example `2026-10-17 Lisbon food trip (2).md`.

## Settings → Folders and filters

![The Folders and filters section of Settings](https://chattomarkdown.com/docs/shots/1.0.1/settings-organise-light.webp "Settings → Folders and filters")

### Subfolder

Empty by default: chats go straight into the folder you chose. Type a name, for example `AI Chats`, to keep them in a folder of their own inside it. This is useful when you chose your whole Obsidian vault and want your chats in one place. You can type a path with `/`, such as `Inbox/AI Chats`.

Press <kbd>Enter</kbd> or click elsewhere to save it. A message confirms **New chats go into “AI Chats”** (or **New chats go straight into your folder** when you clear it).

With a subfolder, the layout becomes `Obsidian Vault/AI Chats/ChatGPT/...`. The table of contents note moves into the subfolder too. The hidden `.chattomarkdown` folder stays at the top of the folder you chose.

### A folder for each service

On by default. Turn it off to put every chat in the same folder (the subfolder, or the folder you chose), with project folders directly inside it.

### A folder for each project

On by default. Chats in a ChatGPT or Claude project, or a Perplexity Space, go into a folder named after it. Turn it off to keep them in the service folder with the rest. The `project` property is still written in the file either way.

When a saved chat later moves into a project, out of one, or its project is renamed, its file moves to the matching folder the next time the chat is saved. Your notes in the file go with it, and its pictures are saved next to it in the new folder.

> [!NOTE]
> These settings apply to chats saved from now on. Files you already have stay where they are, and keep getting updates there.

## Leave chats out

Two filters in the **Leave out** group keep chats from ever being saved. They are useful for test chats, work projects you don't want on this computer, or private topics.

**Skip chats with these words.** Type a word and press <kbd>Enter</kbd> or a comma. A chat whose title contains that word is never saved. Matching ignores capitals and also finds the word inside longer words, so `test` also skips "Latest results". Use longer, specific words.

**Skip these projects.** Type a project or Space name and press <kbd>Enter</kbd>. The field suggests the projects of chats you have saved. A name must match the whole project name (capitals don't matter).

Click the **×** on a chip to remove it, or press <kbd>Backspace</kbd> in the empty field to remove the last one.

What happens to skipped chats:

- Auto-save never downloads nor writes them.
- Clicking **Save** on such a chat yourself still saves it: the rules only apply to saving on its own.
- Files saved before you added the rule stay as they are. Delete them yourself if you want them gone.
- If you remove a rule, the chats it skipped are saved once a sync comes across them, at the latest when they change. To save one straight away, open it on its site and click **Save**.

## Attachments

Pictures and files from a chat are saved in an `attachments` folder in the same folder as the chat's note, and the note shows them with `![[...]]` embeds. Each file keeps its original name with a short code added, such as `market 3f9a1c2e.jpg`. The code keeps names unique across your vault, so Obsidian always finds the right picture. Pictures without a name are called `Image`, pasted text `Pasted text`.

Files Claude made (documents, code, diagrams) also go into `attachments` when **Artifacts as separate files** is on, even with **Images and files** off. Files larger than 25 MB are not saved.

Turn pictures and uploads on or off with **Images and files** in **Settings → What to save**. See [Choose what to save](https://chattomarkdown.com/docs/1.0.1/what-to-save/).

## The hidden history folder

`.chattomarkdown/history` holds the earlier versions of each chat, one file per chat, named by the service and the chat's id. It is at the top of the folder you chose, whatever the subfolder.

Its name starts with a dot, so Obsidian and the macOS Finder don't show it (press <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>.</kbd> in the Finder to see it). Because it is keyed by id, the history stays with a chat even if its file is renamed. Deleting the folder removes the history only; your chats are not affected. See [Version history](https://chattomarkdown.com/docs/1.0.1/version-history/).

## The table of contents note

With **Settings → Obsidian → Table of contents** on, one note links every saved chat, grouped by service, project and month. It is named **AI Chats index.md** by default; you can rename it under **Note name**. It sits in the subfolder, or at the top of your folder without one, and it moves when you change the subfolder. It updates within seconds of each saved chat. See [Table of contents note](https://chattomarkdown.com/docs/1.0.1/table-of-contents/).

## Moving and renaming files yourself

The extension remembers each saved chat by its path inside your folder. This is what it uses to update the file, to show it in the reader and search, and to link it from the table of contents and daily notes.

| You do this | What happens |
|---|---|
| Write in the file, above or below the chat | Safe. Your text is kept. See [What's in a saved file](https://chattomarkdown.com/docs/1.0.1/file-format/#your-own-notes). |
| Add properties to the frontmatter | Safe. Properties you add are kept. |
| Rename or move the file | The reader shows **This file isn’t in your folder**. When the chat changes on its site, it is saved again as a new file in the usual place, so you end up with two copies. |
| Move or rename a project folder or service folder | The same, for every file in it. |
| Delete the file | It comes back as a new file the next time the chat changes on its site. To stop that, add a skip rule above. |
| Remove the start and end markers | The extension never touches that file again. See [What's in a saved file](https://chattomarkdown.com/docs/1.0.1/file-format/#the-synced-block). |

The extension does recognise a file by the `id` in its frontmatter, but only where it expects the file to be. When it saves a chat and finds a file at that path that already holds the same `id` (after a reinstall, for example), it updates that file instead of making a new one. It does not search your whole folder for files you moved.

### Rename files safely

1. **Open Settings → File names** and change the **File name** pattern.
2. **Click Apply… under Files you already have.** It renames every saved file in its folder and updates the extension's records, the table of contents and daily note links.

See [File names and properties](https://chattomarkdown.com/docs/1.0.1/file-names/#apply-to-saved-files).

### Reorganise into other folders

There is no button to move existing files into a new layout. Your options:

- Keep old files where they are and let new chats follow the new settings.
- Use **Settings → Start over** to delete what the extension saved and save everything again with the new layout. Files you have written in are kept unless you choose otherwise. See [Start over or delete saved chats](https://chattomarkdown.com/docs/1.0.1/start-over/).

## Problems

**A chat appears twice.** You moved or renamed its file, and the chat changed on its site, so it was saved again in its usual place. Delete one copy, keeping the one in the usual place.

**New chats don't go into my subfolder.** Check the spelling in **Subfolder**, and press <kbd>Enter</kbd> after typing. Old chats stay where they were.

**A project folder has a different name than the project.** Characters that can't be in a file name or an Obsidian link (`\ / : * ? " < > | # ^ [ ] ~`) are replaced with spaces, and long names are shortened to 80 characters.

## Questions

### Can I rename or move a saved file in Obsidian?

You can, but the extension keeps track of each file by its path. A moved or renamed file no longer gets updates, and the reader can't open it. To rename files safely, change the pattern in Settings → File names and use Apply to saved files.

### Why are my old chats not in the new subfolder?

Folder settings apply to chats saved from now on. Files you already have stay where they are.

### What is the .chattomarkdown folder?

A hidden folder at the top of your chosen folder that holds the version history of each chat. Obsidian and Finder don't show it. Deleting it only deletes the history.
