Skip to content

README.md

Latest commit

 

History

History
73 lines (53 loc) · 1.92 KB

README.md

File metadata and controls

73 lines (53 loc) · 1.92 KB

Medium2Dev

A command-line tool to convert Medium posts to DEV.to markdown format and optionally publish them directly to DEV.to as draft posts.

Features

  • Converts Medium articles to DEV.to compatible markdown
  • Preserves headings, formatting, and text structure
  • Downloads and properly references inline images
  • Removes Medium-specific UI elements and metadata
  • Fixes code link formatting
  • Generates appropriate frontmatter for DEV.to
  • Optionally publishes directly to DEV.to as a draft post
  • Provides word count comparison between Medium and DEV.to versions
  • Simple command-line interface

Installation

# Clone the repository
git clone https://github.com/awsdataarchitect/medium2dev.git
cd medium2dev

# Install dependencies
pip install -r requirements.txt

Usage

# Basic conversion
python3 medium2dev.py https://medium.com/your-article-url

# Specify output directory
python3 medium2dev.py https://medium.com/your-article-url -o /path/to/output

# Specify image directory
python3 medium2dev.py https://medium.com/your-article-url -i /path/to/images

# Publish directly to DEV.to as a draft
python3 medium2dev.py https://medium.com/your-article-url --publish --api-key YOUR_DEVTO_API_KEY

# Or use environment variable for API key
export DEVTO_API_KEY=your_api_key
python3 medium2dev.py https://medium.com/your-article-url --publish

Example

python3 medium2dev.py https://medium.com/aws-in-plain-english/aws-resource-tag-compliance-with-automation-64ae16e42a11

This will:

  1. Download the Medium article
  2. Extract all content and images
  3. Convert to DEV.to compatible markdown
  4. Save the markdown file and images to the specified directories

When using the --publish flag, the tool will also:

  1. Publish the article as a draft to DEV.to
  2. Display a word count comparison between Medium and DEV.to versions

Requirements

  • Python 3.6+
  • requests
  • beautifulsoup4
  • html2text

License

MIT