Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub


GitHub license npm npm downloads total npm downloads GitHub watchers GitHub stars GitHub forks open bugs total open issues GitHub pull requests

Packagephobia Bundlephobia

Gatsby plugin to import your medium posts from a backup as markdown files.


We assume you’ve already created gatsby website using command like this:

gatsby new example https://github.com/gatsbyjs/gatsby-starter-hello-world

Install dependencies

cd example
npm i -s gatsby-source-filesystem gatsby-transformer-remark gatsby-source-medium-backup

Configure your gatsby plugins

Go to gatsby-config.js and configure folder for your processed markdown pages first:

const markdownPages = `${__dirname}/src/markdown-pages`

Then inside the plugins section add gatsby-source-medium-backup first and specify location of your medium backfile inside source:

  resolve: 'gatsby-source-medium-backup',
  options: {
    source: `${__dirname}/medium-export.zip`,
    destination: markdownPages,

Add markdown generation after above plugin!

// markdown
  resolve: `gatsby-source-filesystem`,
  options: {
    path: markdownPages,
    name: `markdown-pages`,
    //prefix: 'blog' // optional: prefix all slugs
    h1h2: true, // optional: convert all h3 and h4 to h1 and h2
    // h2h3: true, // optional: convert all h3 and h4 to h2 and h3

Download your medium archive

Here’s official guide from Medium.

  1. On your homepage, click on your profile picture and click Settings.
  2. Scroll down to the Download your information section.
  3. Click Download . zip and confirm by clicking Export.
  4. A link to download your archive will be sent to you by email when it is finished.

Configure your gatsby blog posts generation

This section essentially follows original guideline for adding markdown pages here

  1. Create ./src/templates/blogTemplate.js, which will be used as a page template for your blog posts.
  2. Configure your ./gatsby-node.js to generate blog posts using markdown files during the build time.

Now run your gatsby

cd example
gatsby develop

Navigate to http://localhost:8000/404 and you’ll see your markdown pages generated.

Screen Shot 2021-04-08 at 20 26 36


  1. Make sure to put absolute path for your medium archive.

  2. This plugin generate following metadata for each post:

  "title": "How to build a react-native plugin in 2021",
  "author": "Eugene Hauptmann",
  "authorLink": "https://medium.com/@eugenehauptmann",
  "canonical": "https://medium.com/@eugenehauptmann/how-to-build-a-react-native-plugin-in-2021-60704edc0c28",
  "timestamp": "2021-04-06T00:58:51.984Z",
  "exportDate": "April 6, 2021"


Thank you to our sponsors:

Reactive Lions™



Copyright (c) 2021 Eugene Hauptmann

© 2023 Gatsby, Inc.