https://github.com/bgadrian/medium-to-hugo

Medium stories exporter to markdown/hugo articles.
https://github.com/bgadrian/medium-to-hugo

blog go golang hugo medium medium-com medium-data

Last synced: 28 days ago
JSON representation

Medium stories exporter to markdown/hugo articles.

• Host: GitHub
• URL: https://github.com/bgadrian/medium-to-hugo
• Owner: bgadrian
• Created: 2018-12-22T14:58:29.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2022-05-09T20:28:38.000Z (over 2 years ago)
• Last Synced: 2024-08-04T01:23:25.817Z (4 months ago)
• Topics: blog, go, golang, hugo, medium, medium-com, medium-data
• Language: Go
• Homepage:
• Size: 263 KB
• Stars: 68
• Watchers: 1
• Forks: 10
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Medium to Hugo

Tool for the migration of articles from a medium.com account to a static website generator with markdown like Hugo.

Here is a preview from my own migration (from medium to Hugo):

![example](./preview.png)

## Features:

* transform HTML posts to markdown

* ignores comments and empty articles

* SEO friendly (keeps the old URL as an **alias**)

* keeps all the metadata and adds most Hugo front Matter, including the alias with the old URL

* even if one article fails it keeps going

* marks the **drafts** as "draft_"

* Fetch the article **TAGS** (which are not included in the Medium exporter), compatible with Hugo Related feature

* Fetch all the **Images** and puts them in each articles bundle

* stories are ordered by date (`year-month-day_slug`)

* custom `.Params`: image, images, slug, subtitle

* minimal HTML cleanup (removed empty URLs, duplicate title and so on)

* adds `#layout...` suffix to every image so they can be styles accordingly from plain CSS with exactly same style as on Medium.

## Usage

1. Download your [medium data](https://help.medium.com/hc/en-us/articles/115004745787-Download-your-information)

2. Unzip it

3. Download our binary (see Releases)

4. Run something like `./mediumtohugo /path/to/export/posts /path/to/hugo/content/ posts`

In case you need to bypass TLS/SSL checks you can run the binary with `ALLOW_INSECURE=true` environment variable. This is a case if the medium certificate expires and you want to export your blog with all tags.

### Build / Contribute

You need Bash, Go 1.11+

See Issues for a list of TODOs.