Use ChatGPT Exports in Obsidian

Export any ChatGPT conversation with ChatCache as a Markdown file, then move it into your Obsidian vault folder. Obsidian indexes it immediately - code blocks render with syntax highlighting, LaTeX math renders if Math is enabled, and tables render natively. You can link to the note with wikilinks and it becomes part of your knowledge graph.

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

1. Install ChatCache from the Chrome Web Store.
2. Open any ChatGPT conversation and click the ChatCache icon.
3. Select Markdown and click Download. The .md file is saved to your Downloads folder.
4. Move the file into your Obsidian vault folder. You can use Finder/Explorer or drag it in.
5. Obsidian 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.

What renders correctly in Obsidian

Organizing ChatGPT exports in your vault

A consistent organization scheme makes exported conversations useful long-term. Common approaches:

• Dedicated folder - create a chatgpt/ or ai-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 tags field integrates with Obsidian's tag search. The date property works with the calendar plugin and Dataview date queries. The source: chatgpt property is useful for filtering - it lets you distinguish AI-sourced notes from your own writing.

File naming works alongside frontmatter. A convention like YYYY-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 a source: 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 DESC

This 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 #python appear 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.