You're reading the docs for 1.0.2. The latest version is 1.0.5. Read this page for 1.0.5

Version history

How up to 100 earlier versions of each chat file are kept, how to read the git-style log and diff in the reader, copy an old version, or turn history off.

View as Markdown

In short

Each time a chat's file changes, the version before is kept, up to 100 per chat, in the hidden .chattomarkdown/history folder. In the reader, a changed chat has a Changes view: a log of versions on the side and a line-by-line diff with changed words highlighted. You can copy any version as Markdown. It is on by default.

On this page
  1. How versions are kept
  2. Open the history
  3. The log
  4. Reading the diff
  5. Compare with
  6. Copy an old version
  7. Where it is stored
  8. Turn history off
  9. Problems
  10. Questions

Chats change: you continue them, the site renames them, you delete them, or you edit the file yourself. With version history, the extension keeps what each file looked like before every change, and the reader shows exactly what changed, like a git log of the file.

How versions are kept

Keep a history of changes is on by default, in Settings → What to save, on every plan.

  • A chat that never changes has no history. Its file is its only version, and there is nothing to compare.
  • The first time the file changes, two versions are kept: what the file held before (First version) and the new one.
  • Each later change adds a version on top.
  • Up to 100 versions per chat are kept. Past that, or past about 4 million characters for one chat, the oldest versions are dropped.

What makes a new version:

ChangeShown asKind
The chat changed on its site and was saved againFor example 2 messages added, Title changed, Messages changedSync
The chat was deleted on its site and marked deleted: trueMarked deleted on the serviceSync
Apply to saved files renamed it or rebuilt its propertiesFile format appliedFile format
You edited the file between two savesEdited in the fileYour edit

Your own edits are noticed when the file is next written: the extension sees that the file differs from the last version it saved, and keeps your edit as a version of its own before writing the new one. So even an edit inside the synced block, which a sync overwrites, can be found again.

Open the history

  1. Open the chat in the reader.
  2. Click Changes in the switch next to Preview and Markdown. It appears only once the file has changed at least once.
  3. Read the log in the History panel on the right, and the diff of the newest change in the middle.
The reader showing a chat's Changes view, with the history log on the right and a diff in the middleThe reader showing a chat's Changes view, with the history log on the right and a diff in the middle
Changes and the History panel

Close the panel with its ×; click Changes again to bring it back. On a narrow window the panel slides over the chat.

The log

The History panel lists every version, newest first, like git log:

  • A short title saying what changed: First saved, First version, 2 messages added, Title changed, Messages changed, Marked deleted on the service, File format applied or Edited in the file. When only properties changed, it names them, for example model changed, or just says Updated.
  • Current on the newest version, which is the file as it is now.
  • A short code such as a1b2c3d, which identifies that version’s exact text, like a commit hash.
  • When: Today, 10:05, Yesterday, 18:40, 17 Oct, 09:41, or a full date for earlier years. Earlier means the version was found in the file before history started; Between saves marks your own edits, whose exact time isn’t known.
  • The kind: Saved, Sync, Your edit, File format or Found in the file.
  • Lines added and removed, in green and red, like +24 −3.

At the bottom: Kept in your folder, in .chattomarkdown/history. The latest versions of each chat, up to 100.

Click a version to see its changes.

Reading the diff

The middle shows one version’s changes as a unified diff of the whole file, properties included:

  • Line numbers before and after, then + for an added line and − for a removed one.
  • Changed words are highlighted within a changed line, so you see exactly which words differ.
  • A changed property shows as one line with its new value and what it was, for example updated: 2026-10-17T11:05:12 with was 2026-10-17T10:41:00.
  • New messages label a run of added lines that brings new ## You or answer headings.
  • Unchanged stretches fold into a row like 42 unchanged lines. Click it to show them.
  • No differences. means the version’s text is the same as the one compared with.

The header above the diff shows the version’s title, its code, Version 5 of 7, when it was made, and the lines added and removed.

Compare with

ChoiceShows
This changeWhat this version changed from the one before. For the oldest version it reads This version and shows all of it as added.
Since thenEverything that changed from this version until now. Not available on the newest version.

The arrows next to the title step to the Older version and Newer version. The file’s path is shown above the diff with how many versions it has.

Copy an old version

There is no button to restore a version, on purpose: the chat’s block is rewritten from the site at the next save anyway. To get old text back:

  1. Open the version in Changes.
  2. Click Copy version. That version’s whole file is copied as Markdown, and a message says This version copied as Markdown.
  3. Paste it where it should live: into a new note, or above or below the chat’s block in its file, where it is kept.

Where it is stored

Each chat’s history is one file in a hidden folder at the top of the folder you chose:

  • Obsidian Vault
    • .chattomarkdown
      • history
        • chatgpt
          • 68f1c2a0-5b7e-8003-9a41-2c6d0e7f1a93.json
        • claude
          • 4b1d6a0e-2f3c-4e5d-9a8b-7c6d5e4f3a2b.json
  • The file is named by the service and the chat’s id, so the history stays with the chat when its file is renamed or moved to another project folder.
  • Only the newest version is stored in full. Older ones are stored as the differences from the next, so a long chat continued many times takes little more room than its last copy.
  • Obsidian and the macOS Finder don’t show folders whose name starts with a dot. In the Finder, press Cmd+Shift+. to see it.
  • It is in your folder, so it is backed up and synced with it.

Turn history off

Turn off Keep a history of changes in Settings → What to save. From then on no new versions are kept. Versions already kept stay, and the reader still shows them.

To delete history, delete .chattomarkdown/history (all chats) or one chat’s file in it. Your chats are not affected.

When history is off and a chat has none, Changes isn’t shown.

Problems

There’s no Changes button. The chat’s file hasn’t changed since it was first saved, so there is nothing to compare. It appears after the first change.

A version I expected is missing. History only records changes made while it was on. Changes made while it was off, and versions older than the 100 newest, aren’t there.

The history shows a secret I hid. Versions from before you turned on Hide secrets keep the text as it was. Delete that chat’s file in .chattomarkdown/history to remove them.

The history folder is missing. It is hidden. Show hidden files, or check you are looking at the top of the folder you chose, not a subfolder.

Questions

Is there a restore button?

No. Open the version in Changes, click Copy version, and paste it where you want it, such as a new note or above or below the chat in its file.

Does version history take a lot of space?

Little. Only the newest version is stored in full; older ones are stored as the differences between them. Past about 4 million characters for one chat, the oldest versions go.

Are my own edits kept in the history?

Yes. When you edit a chat's file and it is later saved again, your edit is kept as a version of its own, marked Your edit.

↑↓ to move ↵ to open Esc to close