The Blog

Convert Markdown to AsciiDoc The Right Way! Use kramdoc

Convert Markdown to AsciiDoc The Right Way! Use kramdoc

May 16th, 2019

If you need to migrate Markdown content to AsciiDoc, there's a tool designed specifically to do it — it's called kramdoc. In this post, I'm going to show you how to use it and relate my experience with it.

How to Convert Markdown to AsciiDoc Using Pandoc

How to Convert Markdown to AsciiDoc Using Pandoc

May 9th, 2019

Markdown is one of the most ubiquitous file formats around at the moment for writing technical documentation — and it's easy to see why! However, it may not be the choice long-term. When it's time to change, you need to be able to migrate to a more feature-rich format. Come learn about the best tool for the job and how to use it.

Find What's Using a Port With Two Commands

Find What's Using a Port With Two Commands

March 5th, 2019

If you've ever attempted to bind a process on a port on Linux, BSD, or macOS, only to find that something else is using the port, yet you don't know what that process is, here's a quick way to find the process and remove it.

Easily Find Broken Links With Broken Link Checker

Easily Find Broken Links With Broken Link Checker

January 29th, 2019

When you're reviewing generated HTML content, broken link's are the last thing you want. However, given the massive amount of documentation in modern projects, manually hunting for broken links isn't practical. So how do you deal with this problem?

Validate Your Markdown files with MarkdownLint

Validate Your Markdown files with MarkdownLint

December 21st, 2018

Markdown is far-and-away the most popular technical documentation format used by developers (in my experience). If you and your team write in Markdown too, how do you know that your Markdown files are valid? You use MarkdownLint. Come learn all about it!

The Three Core Antora Concepts You Need To Know To Use It Fully

The Three Core Antora Concepts You Need To Know To Use It Fully

November 13th, 2018

Antora is the premier technical documentation platform. However, that doesn't mean that it's a breeze to use right from the get-go. If you have just begun using it or want to get the most out of it, this post will step you through the three key concepts that you need to know about.

Automate Repetitive Tasks With Make

Automate Repetitive Tasks With Make

October 18th, 2018

Anything to do with software and computers usually ends up getting tricky, time-consuming, and repetitive. As such, if you value your sanity, you'll want to regularly look for ways to automate these tasks away. One of the best ways to do that, is by using Make - a veteran automation tool.

Why Antora Is The Leading Technical Writing Platform

Why Antora Is The Leading Technical Writing Platform

October 12th, 2018

If you need to create and maintain technical writing, there are a large number of solutions that will give you a lot of what you want. However, which one is the best? Today, I'll show you which one I believe is the best choice.

Are You Too Wedded To Your Text Editor?

Are You Too Wedded To Your Text Editor?

September 10th, 2018

I've been a proud VIM user for years — dating back as far as 1999 — but especially so, since I pushed myself to learn it properly a few short years ago. However, I wonder if I've become too wedded to it. And I'm keen to find out if you are too.

Google Chrome 69 Now Flags HTTP Websites

Google Chrome 69 Now Flags HTTP Websites

September 10th, 2018

Earlier today, I upgraded my installation of Google Chrome from version 68 to version 69. While not a major upgrade, there's a key security update that I want to draw your attention to. Here's a quick look at it.