Claude JSON to Markdown Converter (cj2md)

A command-line tool that converts Anthropic Claude conversation exports to Markdown files.

Installation

# Run directly (recommended)
uvx cj2md <input.json> [output_dir]

# Or install globally
uv tool install claude-json-to-markdown

# Or add to a project
uv add claude-json-to-markdown

Exporting Your Data

Follow Anthropic's export guide:

1. Click your initials (lower left) > Settings > Privacy > Export data
2. Download link arrives via email

Usage

cj2md [OPTIONS] JSON_INPUT_FILE [MARKDOWN_OUTPUT_DIRECTORY]

Arguments

Options

Example

uvx cj2md conversations.json ./output --limit 50 --no-thinking

Output Format

Each conversation becomes a Markdown file named YYYY-MM-DD_slugified-name_uuid.md containing:

• Header: UUID, name, timestamps, optional summary
• Messages: Sender, timestamp, content, attachments
• Thinking blocks: Claude's reasoning (unless --no-thinking)
• Tool usage: Web searches, artifacts, file operations (unless --no-tools)
• References: Citation URLs (unless --no-citations)

Conversations with no name or empty content are automatically skipped.

Development

git clone https://github.com/olearydj/claude-json-to-markdown.git
cd claude-json-to-markdown
uv sync
uv run pytest

Limitations

• Project data from exports is not processed (no clear way to link conversations to projects)
• Artifact content is shown as operations (create/update/rewrite) rather than reconstructed final state

License

MIT

Links

• Issues
• PyPI