A CLI tool that converts medium posts (html) into Jekyll/Hugo compatible markdown files. Also downloads images and adds yaml front matter to the converted markdown files. It works with exported Medium posts (local html files) and converts them to markdown using a single command. It can be useful in scenarios when you want to migrate your blog away from Medium to Jekyll or Hugo (or something similar that supports markdown content).
Steps to use
Convert local Medium exports
- Export and extract your Medium posts from your Medium account.
- Go to
https://medium.com/me/settingsand scroll to
Download your information. Click the download button. This will give you a
medium-export.ziparchive containing all your Medium content.
- Extract the .zip archive downloaded in the previous step. It will have a sub-directory called
- Copy the path of this
- Go to
medium-2-mdon your system.
- Download and Install node.js - https://nodejs.org/en/download/.
- Install medium-2-md -
npm i -g medium-2-md.
- Run the following command to convert all your Medium posts (html) to markdown files,
medium-2-md convertLocal '<path of the posts directory>' -dfi
That's it. The output markdown files will be stored in a sub-directory called
The converted markdown files include front matter containing title, description, published date and canonical URL of the original Medium post/story. The images from the Medium posts are downloaded in a sub-directory called
img inside the output directory.
convertLocal command supports the following optional flags,
--drafts: Convert the drafts too.
--frontMatter: Add the front matter on top of the markdown file.
--images: Download images to a local
Example: Convert from local - drafts enabled
medium-2-md convertLocal E:\\path\\to\\posts\\dir -d
Example: Convert from local - images enabled
medium-2-md convertLocal E:\\path\\to\\posts\\dir -i
Note: The flags do not support any defaults. You need to add them in order to get the respective results (drafts, images and/or front matter inclusion).
When using the
--images flag, the images are downloaded into a sub-directory called
img inside the output directory. If this
img directory does not already exist, it is created. If it already exists, the downloaded images are saved inside the existing directory. The image elements in the converted markdown files link to their respective local paths from the
This package uses: