All posts

How to Read ChatGPT and Claude Exports in Markdown

People export their AI conversations as markdown files. Here's how to export from ChatGPT and Claude, and the best way to read the resulting .md files on Mac.

AI conversations can be genuinely valuable — a debugging session with Claude that walked you through a tricky problem, a ChatGPT thread where you designed a system architecture, a research conversation you want to reference later. Exporting and saving them makes sense.

The most common export format is markdown. And once you have those .md files, you need a way to read them properly — because a wall of raw markdown syntax isn't the same as a formatted, readable document.

Here's how to export from the main AI tools, and how to read the resulting files beautifully on Mac.


How to Export from ChatGPT

ChatGPT has a built-in data export feature that includes all your conversations:

  1. Go to Settings (click your profile icon, bottom-left)
  2. Select Data Controls
  3. Click Export Data
  4. Confirm the export — ChatGPT will email you a download link
  5. Download the ZIP file and extract it

Inside you'll find a conversations.json file (raw data) and an html/ folder with your conversations in HTML format. The HTML renders in a browser but isn't the most portable format.

For proper markdown exports, browser extensions fill the gap:

ChatGPT to Markdown — A popular Chrome/Firefox extension that adds an "Export" button to individual ChatGPT conversations. Saves the conversation as a .md file with the AI and user turns properly formatted.

AI Chat Exporter — Supports multiple AI tools including ChatGPT, Claude, and Gemini. Exports to markdown with frontmatter.

These extensions save individual conversations as .md files that you can store in any folder and open later.


How to Export from Claude

Anthropic's Claude doesn't have a built-in conversation export yet, but there are a few options:

Claude to Markdown (browser extension) — Adds an export button to claude.ai conversations. Saves the full conversation as a markdown file, with headings for each turn and code blocks preserved properly.

Manual copy — The low-tech option. Copy your conversation text, paste it into a markdown file, and clean up the formatting. It works for shorter conversations.

Claude's Projects and Artifacts — When Claude generates code, documents, or structured content in an Artifact, you can copy the content directly. For technical output, this is often cleaner than exporting the full conversation thread.


What the Exported Markdown Looks Like

A typical AI conversation export looks something like this in raw form:

# Conversation: Debugging the authentication flow

**Date:** 2026-02-15

---

**User:** I'm getting a 401 error when calling the /api/user endpoint after login.
The token is definitely being set in localStorage...

**Assistant:** The 401 after login usually means one of three things:

1. The token is being set but not included in the Authorization header
2. The token format is wrong (should be `Bearer <token>`)
3. The token has already expired by the time the second request fires

Let's check each one. Can you show me the code where you're making the API call?

**User:** Here's the fetch call:

```javascript
const response = await fetch('/api/user', {
  headers: { 'Authorization': token }
})

Assistant: Found it. The header value needs to be Bearer ${token}, not just token:

...


In a text editor, you're reading those backticks, asterisks, and `---` separators literally. In a markdown editor, you get:

- The conversation heading properly rendered
- Bold **User:** and **Assistant:** labels
- Numbered lists formatted as actual lists
- Code blocks with syntax highlighting

For a technical conversation — one with code samples, commands, tables, or structured reasoning — the rendered version is dramatically more readable.

---

## The Best Way to Read These Files on Mac

For a single quick read, VS Code's preview (⌘K V) works fine. But if you're archiving many AI conversations and want to actually use them as reference material, a dedicated markdown editor is better.

**[OpenMark](https://openmarkapp.com)** opens any `.md` file and renders it immediately. No split pane, no extensions required. The conversation renders as a proper document — formatted, readable, searchable. You can toggle to edit mode if you want to annotate or clean up the export.

OpenMark also handles code blocks with syntax highlighting, so if your exported conversation includes code samples (which AI conversations almost always do), they look right.

To set OpenMark as the default for `.md` files — so exported conversations open automatically in OpenMark when you double-click them:

1. Right-click any `.md` file in Finder
2. **Get Info** (⌘I)
3. **Open With** → select OpenMark
4. **Change All…**

---

## Organising Your AI Conversation Archive

Once you have a system for exporting, it's worth thinking about organisation. A simple folder structure works well:

~/Documents/ai-conversations/ ├── 2026-02/ │ ├── authentication-debugging.md │ ├── system-architecture-review.md │ └── regex-help.md ├── 2026-01/ │ └── ...


Keep these as plain `.md` files — they're portable, searchable with Spotlight, and will work with any markdown editor you use in the future. No proprietary database, no lock-in.

Because OpenMark opens individual files directly (it doesn't use a vault or database), it pairs naturally with a simple folder structure like this. Open any file from Finder and you're reading it in seconds.

---

## A Note on Privacy

Your AI conversations may contain sensitive information — business plans, code, personal details from your questions. The exported files live on your Mac. A native app like OpenMark that doesn't connect to the internet is the right tool for reading them — your content stays on your machine.

(For more on OpenMark's privacy approach: no analytics, no telemetry, no network requests. See [openmarkapp.com/privacy](https://openmarkapp.com/privacy).)

---

For more on working with markdown files from AI tools, see [What to Do with the Markdown Files Claude Code Creates](/blog/claude-code-markdown-files) and [The Best Markdown Editor for AI-Generated Content](/blog/ai-tools-markdown-editor).

**[Download OpenMark →](https://openmarkapp.com)** — $9.99, one-time. The best way to read and archive your exported AI conversations on Mac.