Asciidoc Articles

How to Set Custom Attributes in the Asciidoctor.js Live Preview Extension

How to Set Custom Attributes in the Asciidoctor.js Live Preview Extension

April 21, 2020

In this post, I step through how to set custom AsciiDoc attributes in the Asciidoctor.js Live Preview Extension for Firefox (and Chromium/Chrome). By doing so, you can preview your content properly and avoid setting attributes directly in your AsciiDoc content and other hacks.

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.

Antora 101: Avoid Duplicate Content With Page and Site Attributes

Antora 101: Avoid Duplicate Content With Page and Site Attributes

April 30, 2019

Writing technical documentation has a lot of similarities to writing software; an important one being content reuse, instead of content duplication. In this post, you’ll learn why and how to use attributes in AsciiDoc and Antora to reuse content as and when needed.

Antora 101: How to Create Redirects

Antora 101: How to Create Redirects

April 30, 2019

Whenever you create online documentation, eventually, the structure needs to change; such as a name change, content restructure, or old content is removed. When these times come, it’s important to create redirects to avoid breaking user expectations. In this post, I’m going to step you through how to do so with Antora.

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.

Why Antora Is The Leading Technical Writing Platform

Why Antora Is The Leading Technical Writing Platform

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