Why Markdown is the right format for Obsidian
Obsidian is built on Markdown - it is the only format that Obsidian treats as a native note. Markdown files in your vault are indexed, searchable, linkable via wikilinks, and visible in the graph view. PDF, HTML, and other formats can be attached to a vault, but they are not indexed as notes - you cannot wikilink into them, they do not appear as nodes in the graph view, and their contents are not searched by Obsidian's built-in search.
ChatCache's Markdown export produces standard CommonMark Markdown with GFM extensions: fenced code blocks with language identifiers, pipe tables, and standard heading hierarchy. This is exactly what Obsidian expects - no conversion, no plugins required for the core content. Code blocks render with syntax highlighting in reading view, tables render as styled grids, and headers appear in the Outline panel on the right side.
How to get a ChatGPT conversation into Obsidian
- 1Install ChatCache from the Chrome Web Store.
- 2Open any ChatGPT conversation and click the ChatCache icon.
- 3Select Markdown and click Download. The .md file is saved to your Downloads folder.
- 4Move the file into your Obsidian vault folder. You can use Finder/Explorer or drag it in.
- 5Obsidian indexes the file automatically. It appears in your file list and is searchable immediately.
ChatGPT to Obsidian in seconds. Export, move, done - no plugins or conversion needed.
Add to Chrome, FreeWhat renders correctly in Obsidian
| Content type | Renders in Obsidian? | Notes |
|---|---|---|
| Code blocks | ✓ | Syntax highlighting with language labels |
| Tables | ✓ | GFM pipe table syntax - native Obsidian support |
| Bold, italic, headers | ✓ | Standard Markdown - fully supported |
| LaTeX math | ✓ (with Math enabled) | Enable in Obsidian settings → Editor → Math |
| Images | Partial | Image references may not resolve if the image source is external |
| Wikilinks in export | N/A | ChatCache exports plain Markdown - wikilinks are added manually after import |
Organizing ChatGPT exports in your vault
A consistent organization scheme makes exported conversations useful long-term. Common approaches:
- Dedicated folder - create a
chatgpt/orai-sessions/folder in your vault and store all exports there - Project-based - file exports into the relevant project folder alongside your other notes
- Date-based naming - name files with a date prefix:
2026-04-18-python-async-patterns.md - Frontmatter tagging - add YAML frontmatter with tags to make conversations findable by topic
Adding frontmatter to your exports
ChatCache exports clean Markdown without YAML frontmatter. Adding it manually takes about thirty seconds and unlocks most of Obsidian's organizational features. Open the exported file in Obsidian, place your cursor at line 1, and add a block like this:
---
title: "Async patterns in Python - ChatGPT session"
date: 2026-04-18
tags: [python, async, chatgpt]
source: chatgpt
project: backend-refactor
---Once the frontmatter is in place, Obsidian displays the properties in the Properties panel (top of the note in reading view) and the tagsfield integrates with Obsidian's tag search. The date property works with the calendar plugin and Dataview date queries. Thesource: chatgpt property is useful for filtering - it lets you distinguish AI-sourced notes from your own writing.
File naming works alongside frontmatter. A convention likeYYYY-MM-DD-topic-slug.md (for example,2026-04-18-python-async-patterns.md) makes the file list sorted chronologically without relying on file system timestamps, which can change when you move or copy files.
Using Dataview to query exported conversations
The Dataview community plugin lets you write SQL-like queries over your vault. If your ChatGPT exports include frontmatter with asource: chatgpt field, you can build a live dashboard of all AI conversations in one place:
TABLE date, title, tags
FROM ""
WHERE source = "chatgpt"
SORT date DESCThis query lists every note with source: chatgpt, sorted by date descending. Narrow it further by adding project or tag filters - for example, WHERE source = "chatgpt" AND contains(tags, "python")shows only Python-related ChatGPT sessions.
Dataview is not required - it is an optional enhancement. You install it via Obsidian's Community Plugins panel (Settings → Community plugins → Browse → search “Dataview”). Without it, your exports still index, search, and link normally.
Linking exported conversations to your notes
Once a ChatGPT export is in your vault, it participates in your knowledge graph like any other note. You can:
- Link from a concept note:
[[2026-04-18-async-patterns]] - Embed a section using Obsidian block references:
![[2026-04-18-async-patterns#Solution]]to pull a specific heading into another note - Tag the note and find it via tag search - all notes tagged
#pythonappear together regardless of folder - Surface it in the graph view alongside related notes - clusters of linked ChatGPT sessions around a topic become visible as a subgraph
Frequently asked questions
Does ChatCache's Markdown export work in Obsidian?
Yes. ChatCache exports to standard CommonMark Markdown with fenced code blocks and GFM table syntax, which Obsidian renders natively. You can drop the file into any vault folder and Obsidian will index it immediately.
Does math render correctly in Obsidian from a ChatCache export?
Yes, if you have Obsidian's Math rendering enabled. ChatCache's Markdown export preserves LaTeX source (e.g., $\frac{1}{2}$), and Obsidian renders this as typeset notation when Math is enabled in settings.
Can I link to an exported ChatGPT conversation from other Obsidian notes?
Yes. Once the exported file is in your vault, use standard Obsidian wikilinks: [[filename]] to link to it from any other note. The conversation becomes a first-class node in your knowledge graph.
Should I use Markdown or another format for Obsidian?
Markdown is the right format for Obsidian - it is Obsidian's native format, so code blocks, tables, and math all render without any conversion. Other formats like PDF or HTML are not natively supported as editable notes in Obsidian.
Can I add YAML frontmatter to the exported file for Obsidian tags and metadata?
ChatCache does not add frontmatter to the exported Markdown. You can add it manually after exporting - open the file in Obsidian, add --- frontmatter at the top with tags, date, or other properties, and Obsidian will treat them as note metadata.
How do code blocks from a ChatCache export render in Obsidian's reading view?
In reading view, Obsidian renders fenced code blocks with syntax highlighting based on the language label. The label (python, javascript, bash, etc.) is preserved from the ChatCache export, so switching from source mode to reading view shows the fully highlighted block. In source mode the raw fences and language identifier are visible.
Can I use the Dataview plugin to query my ChatGPT exports?
Yes, if you add YAML frontmatter to your exports. Add properties like tags, date, and source to each file, then write a Dataview query to list or table all notes where source equals chatgpt. This lets you build a dashboard of all your ChatGPT exports alongside other vault notes.