How to import Markdown into Medium

Andy McFee
Feb 5, 2015 · 2 min read

UPDATE #2: Twitter user Jacob Bennett built a tool called Markdown To Medium which automates the majority of this process.

UPDATE: I have gotten several responses over the past few months of people telling me that this method no longer works. If you find a workaround, let me know, and I’ll update this again.

I’ve figured out an easy way to import Markdown into Medium.

I write these Train of Thoughts posts as Markdown files. Medium doesn’t allow for Markdown in a story, leaving me with random #, *, _, and [] throughout my story.

At first, I had to manually go through and modify my story in Medium and remove all of my markdown formatting. This was a pain. Here’s how I fixed it (NOTE: you will need a GitHub account to do this):

1. Go to and select “markdown” as the Language (or just give it a filed name with a .md extension)

2. Copy/Paste your markdown file into your gist.

3. Click “Create Secret Gist

4. Copy URL of your newly created secret gist

5. Go to Medium and select “Import Story

6. Paste your link and Import.

That’s it. You can then remove the “Originally published…” at the end of the Medium story if you want.

This works because secret gists aren’t 100% hidden, they can be accessed by the URL directly. It’s not as easy as it could be if Medium supported Markdown, but it’s far easier than manually reformatting your entire story in Medium.

Andy McFee

Written by

Head of Product Strategy and Design at beqom in Nyon, Switzerland.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade