ChatGPTの 公式データエクスポート(conversations.json) を、検索・保管しやすい Markdown(.md) に変換するスクリプトです。
- ✅ ChatGPT公式エクスポートの
conversations.jsonに対応 - ✅ 変換モード
per_month:**月ごと(YYYY-MM)**に束ねて出力per_chat:会話ごとに1ファイルで出力
- ✅ 出力は UTF-8 の Markdown
- ✅ オフライン実行(外部API不要)
ChatGPTの設定から Export data を実行し、届いたZIPを解凍します。
解凍後、以下のファイルが含まれます:
conversations.json
※ エクスポート方法のUIは変更される可能性があります。
必要に応じて「ChatGPT Export data」で検索してください。
python export_chatgpt_to_md.py conversations.json --mode per_month -o out_mdWindowsで
pythonが通らない場合はpyをお試しください:
py .\export_chatgpt_to_md.py .\conversations.json --mode per_month -o .\out_mdpython export_chatgpt_to_md.py conversations.json --mode per_month -o out_md出力例:
out_md/
2025-12_chatgpt_bundle.md
2026-01_chatgpt_bundle.md
...
python export_chatgpt_to_md.py conversations.json --mode per_chat -o out_md出力例:
out_md/
20260103_MyTitle_ab12cd34.md
20251230_OtherTitle_ef56gh78.md
...
| オプション | 説明 | 例 |
|---|---|---|
conversations_json |
入力ファイル(必須) | conversations.json |
-o, --out |
出力ディレクトリ | -o out_md |
--mode |
出力モード(per_month / per_chat) |
--mode per_chat |
-
ChatGPTのエクスポート形式は将来的に変更される可能性があります。
-
一部の会話はメッセージツリー構造の都合で、表示順の再現が完全でない場合があります。
-
変換結果に機密情報が含まれる場合があります。公開・共有時はご注意ください。
本ソフトウェアは MIT License の条件に基づき「現状のまま」提供され、いかなる保証もありません。利用により生じた損害について、著作者は責任を負いません。
依存ライブラリはありません(Python標準ライブラリのみ)。
動作確認の目安:
- Python 3.10+ 推奨(3.11/3.12でもOK)
Issue / PR 歓迎です。
MIT License(LICENSE を参照)
Convert ChatGPT exported conversations.json into Markdown files.
python export_chatgpt_to_md.py conversations.json --mode per_month -o out_mdModes:
-
per_month: bundle byYYYY-MM -
per_chat: one file per conversation