Asciidoctor Windows

Last Update:

Author: Christoph Stoettner
Read in about 1 min · 127 words

Fountain pen and a notebook

Photo by Aaron Burden | Unsplash

During my talk at FrOSCon I wasn’t sure how to install Asciidoctor on Windows. So I tried on a Windows 10 VM.

When you want to use Asciidoctor on a Windows desktop, you need to download the Rubyinstaller and install it.

Now you can open a administrative command window and install with gem install asciidoctor.

Let’s test with an easy document:


= Test Asciidoctor on Windows
:icons: font

== Admonition

NOTE: Will this work?

TIP: Convert with `asciidoctor test.adoc`

windows adoc


I had a typo in the conversion command, you can still see it in the screenshot. Sorry about that. You need to convert the source with asciidoctor test.adoc not .html!

To get the easy install into the documentation, I created a pull request at Github .

Add a comment
There was an error sending your comment, please try again.
Thank you!
Your comment has been submitted and will be published once it has been approved.

Your email address will not be published. Required fields are marked with *

Suggested Reading
Aaron Burden: Fountain pen and a notebook

I write most of my documentation with Asciidoctor , so saving some keystrokes is important.

You can add window=_blank to links in your Asciidoctor source.

Last Update:
Read in about 1 min
Aaron Burden: Fountain pen and a notebook

For GPN19 I prepared a second talk on Documentation with any Editor . The talk was based on a previous one from Froscon 13, but the pipeline tooling changed.

This time there was a technical issue during the recording and so there are only the slides available, but you can still watch the video of the Froscon talk: Froscon 13: Documentation with any Editor

Last Update:
Read in about 8 min
Card image cap

I work on a quite large 4k UHD display all day and I often had the issue, that I wanted to share my screen with attendees of different collaboration products. Then the display resolution of 3840x2160 pixel makes my screen very tiny on the remote displays and attendees complain about it.

Created: Read in about 2 min