ChatGPT to Markdown

Convert ChatGPT conversation JSON files to Markdown format with ease.

Usage

Go to chat.openai.com > Settings > Data controls > Export data and export your data.

Unzip the file you're mailed and run:

npx chatgpt-to-markdown path/to/your/conversations.json

NO NEED TO INSTALL - npx will automatically install the package if it's not already installed.

This will generate one Markdown file for each chat same directory as the conversations JSON file. The file name will be the chat title, with invalid filename characters replaced by spaces.

Example

Here's an example of the Markdown output for a chat with the title Medium-Style Table CSS:

# Medium-Style Table CSS

- Created: 26/9/2023, 10:10:54 am
- Updated: 26/9/2023, 10:11:19 am

## user

    Generate CSS for a Medium-style table

## assistant

Creating a Medium-style table requires a clean and minimalist design. Here's a simple CSS snippet to help you create a table that resembles the style seen on Medium. This code assumes that you have a basic HTML table structure in place.

```css
/* Resetting some table styles */
table {
    border-collapse: collapse;
    width: 100%;
    margin-bottom: 20px;
}
...
```

Installation

npm install chatgpt-to-markdown

API

You can also use chatgpt-to-markdown programmatically in your JavaScript or TypeScript projects.

import chatgptToMarkdown from "chatgpt-to-markdown";

const json = [
  // ... your ChatGPT conversation data
];

const sourceDir = "./output";
const options = {
  dateFormat: (d) => d.toLocaleString(),
};
chatgptToMarkdown(json, sourceDir);

Options

• dateFormat: A function that takes a Date object and returns a string. Defaults to a string format like "1 Jan 2023 11:30 PM".

Contributing

• Create a new branch for your feature or bugfix.
• Make your changes.

Contributing

• Fork the repository on GitHub and clone the fork to your machine.
• Run npm install to install dependencies
• Edit index.js or cli.js, documenting your changes
• Push your changes back to your fork on GitHub and submit a pull request to the main repository.

Release

npm version minor
npm publish
git push --follow-tags

Release notes

• 1.5.5: 02 Nov 2024. Add conversation link. Use conversation ID as fallback title if title is empty.
• 1.5.4: 02 Nov 2024. Skip user_editable_context to avoid polluting Markdown with custom instructions
• 1.5.3: 05 Aug 2024. Show text from multimodal prompts
• 1.5.2: 05 Aug 2024. Show tether_browsing_display summary
• 1.5.1: 22 Mar 2024. Handle unicode filenames
• 1.5.0: 28 Nov 2023. Handle tether_browsing_display, tether_quote and system_error
• 1.4.0: 29 Oct 2023. Handle multi-modal text from Dall-E
• 1.3.0: 29 Sep 2023. Set create and update dates from chat
• 1.2.0: 28 Sep 2023. Added test cases
• 1.1.0: 26 Sep 2023. Add date format option
• 1.0.0: 26 Sep 2023. Initial release

License

MIT

Support

If you encounter any problems or have suggestions, please open an issue or submit a pull request.