What's in a saved file
A saved chat file explained line by line: properties, the synced block and your notes, message headings, thinking, tool calls, sources, artifacts and pictures.
In short
Each saved chat is a plain Markdown file: YAML properties at the top, then a block between two chattomarkdown comments that holds the title and the messages under ## You and ## <service> headings. The extension only ever rewrites that block and its own properties, so anything you write above or below it is kept.
Every saved chat is one plain .md file. You can open it in Obsidian, any Markdown editor, or a text editor. This page walks through a real file from top to bottom and explains each part, so you know what you can change and what the extension will keep up to date.
A complete example
This is a ChatGPT chat in a project called Travel, saved with Model thinking and Tool calls turned on. It was produced by the extension’s own code.
---
title: "Lisbon food trip"
source: "ChatGPT"
url: "https://chatgpt.com/c/68f1c2a0-5b7e-8003-9a41-2c6d0e7f1a93"
id: "68f1c2a0-5b7e-8003-9a41-2c6d0e7f1a93"
model: "gpt-5"
created: 2026-10-17T10:41:00
updated: 2026-10-17T11:05:12
tags: [ai-chat, chatgpt]
project: "Travel"
---
<!-- chattomarkdown:start · updated automatically on sync; write your own notes above or below this block -->
# Lisbon food trip
## You
![[market 3f9a1c2e.jpg]]
Plan 3 days of eating in Lisbon. Here is the market I liked.
## ChatGPT
> [!abstract]- Thinking
> **Planning the days**
> Group by neighbourhood so walking stays short.
Day 1 starts at Time Out Market.[^1] Budget about $\frac{60}{3} = 20$ euros a meal.
**Tool call → web**
```
search("pastel de nata best bakery")
```
[^1]: [Time Out Market Lisboa](https://www.timeoutmarket.com/lisboa/)
## You
Draw the plan as a diagram.
## ChatGPT
```mermaid
graph LR
A[Day 1: Baixa] --> B[Day 2: Belém] --> C[Day 3: Alfama]
```
<!-- chattomarkdown:end -->The sections below go through it part by part.
Properties
The lines between the two --- at the top are YAML frontmatter. Obsidian shows them as properties.
| Property | What it holds |
|---|---|
title | The chat’s title on its site. Chats without one get their first words, or “Untitled chat”. |
source | The service: ChatGPT, Claude, Gemini, Copilot (Microsoft Copilot), Perplexity, Grok, DeepSeek or GitHub Copilot. |
url | The chat’s address on its site. |
id | The chat’s id on its site. Always written: it is how the file is matched to its chat. |
model | The model that answered, when the site says. |
created | When the chat started, in your computer’s local time. |
updated | When the chat last changed on its site. |
tags | ai-chat, the service’s id (chatgpt, claude, gemini, copilot, perplexity, grok, deepseek, ghcopilot) and any extra tags you set. |
project | The ChatGPT or Claude project, or Perplexity Space, when the chat is in one. |
messages | Number of messages. Off by default. |
words | Number of words in the messages. Off by default. |
private | true for a temporary or incognito chat, which isn’t in the site’s history. |
deleted, deleted_at | Added when the chat is deleted on its site. See Deleted chats. |
Choose which properties are written, and add extra tags, in Settings → File names. See File names and properties.
What happens to properties on each save:
title,source,url,id,model,created,updated,project,messagesandwordsare rewritten from the chat every time it is saved.tagsis written only when the file is created. Tags you add or remove later stay as you left them.- Properties you add yourself (for example
rating: 5orstatus: read) are never touched.
The synced block
The block starts with this comment:
<!-- chattomarkdown:start · updated automatically on sync; write your own notes above or below this block -->and ends with:
<!-- chattomarkdown:end -->Everything between them is generated from the chat, and rewritten each time the chat is saved again (for example after you continue it on the site). The comments don’t show in Obsidian’s reading view.
If you remove either marker, the extension treats the file as yours and never changes it again. The sync log notes it as Left “…” as it is: its start and end markers were removed. Put the markers back to resume updates.
Your own notes
Write anything above the start comment or below the end comment. It is kept when the chat is updated. Here is the same kind of file after a few edits of your own and a sync:
---
title: "Sourdough starter schedule"
source: "Claude"
url: "https://claude.ai/chat/4b1d6a0e-2f3c-4e5d-9a8b-7c6d5e4f3a2b"
id: "4b1d6a0e-2f3c-4e5d-9a8b-7c6d5e4f3a2b"
model: "claude-sonnet-4-5"
created: 2026-10-20T09:00:00
updated: 2026-10-20T09:20:00
tags: [ai-chat, claude, baking]
messages: 2
words: 14
rating: 5
---
My notes: try rye next week.
<!-- chattomarkdown:start · updated automatically on sync; write your own notes above or below this block -->
# Sourdough starter schedule
## You
Make me a feeding schedule as a table.
## Claude
Here is a week of feedings:
<!-- chattomarkdown:end -->
Follow-up: it doubled in 6 hours.rating: 5, the line above the block and the line below it were written by hand. The extension keeps all three.
Warning
Edits inside the block last only until the chat is saved again. Then the block is rewritten from the chat. The version history keeps your edit as its own version, so you can copy it back out. See Version history.
Title and messages
The block starts with the title as a # heading. Each message follows under a ## heading: ## You for your messages, and the service’s name for its answers (## ChatGPT, ## Claude, ## Gemini, ## Copilot, ## Perplexity, ## Grok, ## DeepSeek, ## GitHub Copilot).
Answers keep their own formatting: headings, lists, tables, code blocks with their language, links and quotes.
Thinking
With Model thinking on (off by default), the reasoning a model shows before its answer is saved above the answer. How thinking looks decides the style.
Callout (default) is an Obsidian callout, folded until you click it:
> [!abstract]- Thinking
> **Planning the days**
> Group by neighbourhood so walking stays short.Plain is a bold label and a quote, which any Markdown app shows:
**Thinking**
> **Planning the days**
> Group by neighbourhood so walking stays short.Tool calls
With Tool calls on (off by default), the web searches and code runs behind an answer are saved as a bold label and a code block:
**Tool call → web**
```
search("pastel de nata best bakery")
```Sources
Web sources an answer cites become footnotes. The marker sits where the site showed the citation, and the list of sources follows the message:
Day 1 starts at Time Out Market.[^1] ...
[^1]: [Time Out Market Lisboa](https://www.timeoutmarket.com/lisboa/)Numbers run through the whole chat, so a source cited again later keeps its number. Sources an answer listed without citing them in the text go into a folded callout under it:
> [!info]- More sources (1)
> - [Visit Lisboa \[official\]](https://visitlisboa.example/)Artifacts and canvases
Code, documents and diagrams Claude makes are saved with Claude artifacts on (the default). With Artifacts as separate files on (also the default), each one is its own file in the attachments folder, shown inside the note:
**Artifact: Feeding schedule**
![[Feeding schedule 794b3f96.md]]With Artifacts as separate files off, the content is written into the note itself:
**Artifact: Feeding schedule**
```markdown
| Day | Flour | Water |
|---|---|---|
| Mon | 50 g | 50 g |
```ChatGPT canvases are saved where they were made, as a > [!note] Canvas: <name> callout for documents and a code block for code. Charts and interactive answers are saved as a page in attachments, which the reader runs. See The reader.
Pictures and uploads
With Images and files on (the default), pictures and uploaded files are saved in an attachments folder next to the note and embedded where they appeared:
![[market 3f9a1c2e.jpg]]Pictures, audio, video and PDFs use ![[...]] so Obsidian shows them. Other files get a plain [[...]] link.
When a picture isn’t saved (the option is off, or the download failed), its place shows *[image]*. Uploaded files that aren’t saved are listed by name, with Names of uploaded files on:
*Attachments: brief.pdf, logo.png*Earlier versions
With Earlier versions on (off by default), the other versions of a message you edited, or of an answer you asked for again, are kept in a folded callout under it:
## ChatGPT
Blue.
> [!note]- Other versions (1)
> **Version 1 of 2 · earlier**
>
> Red.Math and diagrams
Formulas are saved as LaTeX, the way the chat site wrote them: $...$ inline and $$...$$ (or \[...\]) on their own line. Obsidian and the reader draw them.
Mermaid diagrams are saved as ```mermaid code blocks. Obsidian draws them natively, and so does the reader.
Deleted chats
With Keep chats you delete on (the default), a chat you delete on its site stays in your folder, and two properties are added:
deleted: true
deleted_at: 2026-11-02T14:03:00The rest of the file stays as it was. If the chat comes back on the site (you restored it), the properties are removed at the next save. See Choose what to save.
Problems
Obsidian shows [!abstract]- as text. Your app has no callouts. Set How thinking looks to Plain, then use Apply to saved files in Settings → File names to switch existing files.
A picture shows as *[image]*. It wasn’t saved. Check that Images and files is on and that the popup doesn’t ask you to allow the service’s picture server. Then use Re-sync in the reader on that chat.
My notes inside the block disappeared. The chat was saved again and the block rewritten. Find your text in the chat’s Changes in the reader, and move it above or below the block.
A file stopped updating. One of its markers was removed or changed. Compare it with the example above and put both back.
Questions
Can I write my own notes in a saved chat file?
Yes. Write above the start comment or below the end comment. The extension never changes text outside its block, and properties you add are kept.
What happens if I edit the messages inside the block?
Your edit stays until the chat is saved again, for example when you continue it on the site. Then the block is rewritten from the chat. The version history keeps your edit as its own version.
Will the files work outside Obsidian?
Yes. They are plain Markdown. Obsidian-only parts are callouts and ![[...]] embeds; set How thinking looks to Plain if your app has no callouts.