Image for post
Image for post

Tips for writing Medium articles

Per Harald Borgen
Nov 27, 2016 · 5 min read

This article is a summary of what I have learned through writing over 20 Medium articles, gaining over 600 000 views and 300 000 reads.

Though there has been written a ton of articles like this, I still think this one can provide value to some aspiring Medium writers.

1. Use the Medium formatting options

People like to read articles that looks like this:

Image for post
Image for post

Not like this:

Image for post
Image for post

2. Use a wide header image

You want your article to look like in the feed:

Image for post
Image for post

And not like :

Image for post
Image for post

3. Break up the article

Images are also important to break up the text. Even if it’s just a screenshot of a webpage:

Image for post
Image for post

Alternatively, you can embed a YouTube video:

Or use a link to another Medium article as a replacement. It’ll look like this:

All of the options above will help break up the article and make it easier to read.

4. Submit your article everywhere

Research online communities (reddit, Facebook groups, forums, newsletters) which might be interested in your article and share it with them.

This effort is often what separates if an article gets 1K readers or 10K readers.

So spend at least an hour doing this. Since you never know which community will receive your article well, it’s better to submit it to one too many than one too few.

Just check out how this CSS article performed on the seemingly identical /coding and /programming subreddits:

Image for post
Image for post

5. Write a lot of articles

You never know which post will take off.

I thought Side Effects of 100 Days Without Alcohol would be a success.

I also remember thinking a few hours after publishing Machine Learning in a Year.

Here’s how they ended up performing compared to each other:

Image for post
Image for post
Image for post
Image for post

6. Cut mercilessly

It’s important to kill your darlings. Small digressions — no matter how well written — tend to make make articles unfocused and tiring to read.

A trick for cutting away stuff is to create a LEFTOVERS section at the bottom of the article. When I consider cutting something away, I move it down to the LEFTOVERS section temporarily, to see how the article works without the paragraph.

This lowers the threshold for cutting away unnecessary fat. And no, I never move the paragraphs back up again.

7. Publish when you’re 95 percent ready

The last 5 percent should be done after you’ve published. They will take forever when being in draft modus, but once published, it becomes clearer what you need to do.

No matter how many times I read through drafts of my text, there’s almost always someone who’ll find an error somewhere. And that’s ok. I’d rather spend an hour doing more productive stuff than reading through my article the 20th time.

Image for post
Image for post

8. Create value for the reader

Before you write an article, you should ask yourself:

Will someone actually gain something by reading this?

As I write about learning stuff, I try to only give actionable advice. Specific stuff I’ve tested myself and experienced positive results from.

9. Ignore the haters

When you stick your head out there, you’ll get your fair share of haters. Take it as a compliment that someone actually reacts to what you read, or alternatively just ignore it all together.

Image for post
Image for post
Image for post
Image for post

10. Get their email (or something else)

Getting a new Medium follower isn’t worth much. Even with more than 5K followers, I can get as little as 150 views on a Medium post.

If you’re willing to put hours into writing an article, you should spend five extra minutes to setup a newsletter (e.g. TinyLetter), and link to it below your post. Alternatively you can link to other social channels where they can follow you.

Image for post
Image for post

Speaking of which, please enter your email here if you’d like to be notified when I write a new article.

Thanks for reading! My name is Per, I’m a co-founder of Scrimba — a better way to teach and learn code.

Image for post
Image for post

If you’ve read this far, I’d recommend you to check out this demo!

Learning New Stuff

A publication about improving your technical skills.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store