mdium

mdium

mdium is a Go package for downloading Medium articles as markdown files.

Tech Stack

Requirements

• Go 1.23 or higher

Installation

As a Package

go get github.com/0xydev/[email protected]

As a Command Line Tool

go install github.com/0xydev/mdium/cmd/[email protected]

Features

• Download articles from:
  • User profiles (e.g., @Medium)
  • Medium blogs (e.g., blog.medium.com)
  • Publications (e.g., medium.com/netflix-techblog)
• Convert articles to markdown with YAML frontmatter
• Limit the number of articles to download
• Customizable output directory

Usage

Command Line

# Download from a user profile
go run cmd/mdium/main.go -user Medium -output user_articles -limit 5

# Download from Medium's blog
go run cmd/mdium/main.go -domain blog.medium.com -output blog_articles -limit 3

# Download from a publication
go run cmd/mdium/main.go -domain medium.com/netflix-techblog -output pub_articles

As a Package

package main

import (
    "log"
    "github.com/0xydev/mdium"
)

func main() {
    // Download from a user profile
    client, err := mdium.NewClient("Medium", "articles")
    if err != nil {
        log.Fatal(err)
    }
    
    err = client.DownloadArticles(5)
    if err != nil {
        log.Fatal(err)
    }

    // Download from a publication
    pubClient, err := mdium.NewClient("medium.com/netflix-techblog", "netflix_articles")
    if err != nil {
        log.Fatal(err)
    }
    
    err = pubClient.DownloadArticles(0) // Download all available articles
    if err != nil {
        log.Fatal(err)
    }
}

Output Format

Articles are saved as markdown files with YAML frontmatter:

---
title: "Article Title"
date: 2024-02-19T10:00:00Z
link: "https://medium.com/..."
author: "Author Name"
---

Article content in markdown...

Limitations

• Medium's RSS feed is limited to the latest 10 articles
• Some Medium articles might have formatting differences when converted to markdown

License

MIT License - see LICENSE file for details