Technical Writing Articles

How to Include Remote Sources in AsciiDoc

How to Include Remote Sources in AsciiDoc

April 9, 2020

AsciiDoc can include code from remote sources, not just local files. In this post, I’m going to show you both how to do it, as well as how doing so can make your content extremely flexible and much less intensive to maintain.

Convert Markdown to AsciiDoc The Right Way! Use Kramdoc

Convert Markdown to AsciiDoc The Right Way! Use Kramdoc

April 16, 2019

If you need to convert Markdown content to AsciiDoc, there’s a tool specifically designed for the job — 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

April 9, 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.

Sometimes, Answers Lie In Plain Sight

Sometimes, Answers Lie In Plain Sight

April 10, 2017

Have you ever been stuck on a problem and thought that the answer had to be complex or sophisticated. Did you ultimately find that you overcomplicated the situation? If you do, don’t fret. It happens to all of us at times. Come with me today, as we consider how to not get lost in complicated answers to simple questions.