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.
ChatCache's Markdown export produces standard CommonMark Markdown with GFM extensions (fenced code blocks, pipe tables). This is exactly what Obsidian expects — no conversion, no plugins required for the core content.
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
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
- Tag the note and find it via tag search
- Surface it in the graph view alongside related notes
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.