Tips on How to Write Your First Successful Technical Blog
Introduction
If you have never written a technical blog before, it can seem a bit overwhelming. You might even be asking yourself, “Where do I even start?” If you find yourself in this position, the point of this blog is to help break down the whole process into something a little more easily digestible. Once you know some of the fundamental building blocks, the actual writing process will be a lot easier. But before diving into how to create a blog, I will briefly discuss why you should write one.
Why You Should Write a Technical Blog
There are many benefits to writing a technical blog and not only for the sole purpose of helping others. If you’re still on the fence, then here are five reasons why you should seriously consider creating one.
- The best way to learn something is to teach others the knowledge that you have gained. Regurgitating that information will solidify it more firmly in your mind.
- You are providing value where you work while building your own. Your company will appreciate that you went out of your way to show others how to solve a particular problem that you came across.
- You are practicing your critical thinking skills. Doing research, collecting data, formulating that information into something comprehensible to others, all require you to use critical thinking. It’s like a muscle: when you exercise that part, you become much more efficient and quicker at figuring out problems.
- Part of being a valued employee entails being an effective communicator. Displaying this in a blog is an easy way to showcase this skill or improve on if you are lacking. It’s one thing to solve a problem on your own, but it’s quite an entirely different process when you have to convey an idea that is easily understood by a wide array of people.
- Last but not least, potential recruiters now more than ever go online to see what cool projects you have worked on in the past. This is a great opportunity to put some of your work out there to the public. They will be impressed that you actively took the time to research and then share that knowledge with an online audience.
Idea
The first step is figuring out what it is you are going to be writing about. Think about all the past or recent projects you have worked on. Was there a time where you came across a difficult problem that you were unsure about how to handle and solve, but eventually figured out? If so, then this would be a great opportunity for you to share this bit of knowledge by writing an informative blog on how you went about solving that issue.
Usually, 9 times out of 10, if you have come across a problem, then someone else has too, so why not impart some of that useful knowledge to others?
Research
As with anything you will be sharing, you will need to do some groundwork ahead of time. Go on Google to look up what research has already been done on the subject you are wanting to address. Go to websites that you visited in the past and pull what you need. Doing this is not cheating, in fact, you are saving yourself precious time going this route. Why waste energy when someone else has done a lot of the initial work? All you are doing is collecting those useful pieces of information and consolidating them into one, easy resource for an individual to extract from.
From there you can put that information that you have collected into a Google doc or Evernote if you choose. When you are ready to write your blog, you can easily go back and reference those notes.
Medium can also provide a plethora of useful how-to blogs, so check out what has already been written on your topic of interest. This can be a great resource to explore, in regard to blog formatting. When I first started writing blogs I actually went through a lot of different ones related to my field and studied the various structures, cover photos, common topics, and writing styles. To get an idea of whether or not a blog was received well by the public, I would pay attention to how many claps it got and if there were any consistent correlations. Once you find a consistent pattern, try to mimic it and see what happens.
Overall Structure of a Blog Post
- Title
- Cover photo
- Introduction
- Body
- Conclusion
Blog Title
You should create a title that is going to get straight to the point and capture your reader’s attention right off the bat. After all, this is one of the first things they will be looking at when searching for information related to their problem.
Most readers prefer Numbers in titles since our brains are geared towards thinking of things in a logical manner. For example, a blog titled “5 Hacks to Help You Succeed as a Developer” will tend to get way more engagement.
Including You in your title will also get more viewer recognition. When you address your reader, it feels more personal and as if you are actually talking to them.
Starting your title with How-to is also a great way to appear well in Google’s search. A lot of people tend to type “How” into Google when looking for an explanation, so including this is another useful tip.
Based on research from Conductor:
- 36% of people preferred titles with numbers
- 21% of readers liked reader-addressing headlines
- 17% wanted a headline to include “How to”
A good article to visit that will help you determine what a good title consists of is Sprout Social’s, Headline writing: 10 ways to get more eyes on your content.
Cover Photo
A good cover photo is just as important as the title of your blog. It should be clean, have a good quality image, and match your topic. Some sites with high-quality stock photos that I tend to hit up frequently are Unsplash, Pixabay, and Pexels.
If you have an in-house design team at your disposal, then ask one of them if they would have some time to help you create a cover photo for your blog. Usually, they can get this done for you in a reasonable amount of time, but I would suggest giving them at least a week’s notice.
For the sample technical blog post, I used this article as a model to demonstrate the tools I used to write the post:
<p>{{title}}</p>
<div><img decoding="async" alt="item" src="{{itemImageUrl}}"></div>
