What I think about when I edit blog posts - Ian Vanagas

Ian Vanagas

SubscribeSign in

What I think about when I edit blog posts<br>Lessons from editing 439 blog posts in the last 4 years (and beyond)<br>Ian Vanagas<br>Aug 05, 2026

Share

I edit a lot of blog posts. My GitHub stats say I’ve reviewed nearly 450 posts over the past 4 years at PostHog and I’ve edited dozens more for friends and Foster beyond that.<br>Blog posts are a genre of their own. They are not college essays, scientific papers, letters to friends, or books. I’m sure many ideas of what makes good writing carry over from those, but I’m not pretending I know anything about editing in those areas.<br>Blog post editing is a distinct skill. There has been a lot written about blog posting, but not so much about blog editing. To help you get better at it (and think through how I do it), here’s what I think about when I edit blog posts.<br>Why write this particular blog post?

I don’t believe in blogging for the sake of blogging. Writing for the sake of writing is journaling. Simply existing is not enough.<br>Your post should have some purpose for existing and that means answering these questions before you write anything:<br>Why should someone read this?

Why this over something else they can read?

What puts you in a unique place to write it?

Your post should be entertaining, informative, or revealing. You should have the authority to write it, or build that authority in the work you’ve done to write the post.<br>This isn’t to say your reason needs to be validated. I’ve seen many posts with a strong reason to exist do poorly, and posts with weak reasons to exist do well. You can’t predict which of your posts will be popular.<br>Say your best stuff first

Once you’ve decided a piece should be written, there’s not a lot of editing to do until at least some of it is written. Once written, even an outline, the next step in editing is to check if the structure makes sense.<br>My biggest bit of structure advice for blog posts is just say your best stuff first. Get to the point.<br>Many times the best bit of a post is the title. You can write a great post with just a title and almost nothing else.<br>Reality has a surprising amount of detail

A blog post is a very long and complex search query to find fascinating people and make them route interesting stuff to your inbox

Violence and the Sacred: College as an incubator of Girardian terror

It’s Time to Build

Speed matters: Why working quickly is more important than it seems

The body of the post backs up the title, but it is the title that sticks with you the entire time.<br>The best stuff should be up front because the internet is competitive. You are fighting against every other blog, MrBeast, TikTok, Slack, everything. You need to hook people somehow.<br>Don’t save your best content for the conclusion. If you are writing “lessons learned,” consider just making lessons learned the piece. Weave the lessons and examples together.<br>Conclusions are not a good place to put information. Realistically, people get bored and drop off. Most people don’t scroll at all. If you really want to tell them something, tell them at the beginning.<br>Let the examples guide you

The most important part of blog posts is the examples. This is the evidence to show whatever you are saying is true.<br>Because anyone can write whatever they want, it can be tempting to just write down all your thoughts and opinions and assume others will agree with you, but what’s obvious to you is not obvious to others.<br>Instead, let the examples guide you. If you don’t have examples for something, it might not even exist. You need to do more research to find out. There have been countless times when I’ve edited a post, pushed for an example, and it hasn’t existed. This weakens not only that point, but the entire post.

The thing is that examples take a lot of work. They are the research. The good part is that blogging lets you rely on your own experiences as evidence a lot more than other mediums. Examples back up your authority, they are ways for ideas to stick in people’s minds. Readers may not understand a concept, but they can if you give them an example.<br>When you look at the very best bloggers, what makes them so great is their obsession with examples. The writing of James Clear, Morgan Housel, and Ryan Holiday puts the example at the core of everything they write.<br>Be coherent

It’s obvious, but blog posts need to make sense. They need to make sense to me as an editor if they are going to make sense for a reader. Despite knowing this, there is always a part of a post that doesn’t make sense (whether it’s my own or others). We writers are just blind to this.<br>Some common ways blog posts don’t make sense:<br>The titles, headings, and body need to work together. For example, if the title is “What we’ve learned about X,” the headings should be lessons.

You need to deliver on the promise. A title and intro create expectations and the rest of the body should fulfill these...