Asciidoc feature tour on Blogger

· Read in about 2 min · (400 words) ·

So this post is more a memory aid for me rather than anything as I transition over to using asciidoc for my blogging/general technical writing needs. Content is almost verbatim from the asciidoc online user manual - but since I have to wrangle blogger css a bit, this is basically to check if everything works as advertised on the tin styling wise.

Code with callouts

using log4net;
using log4net.Config;
using log4net.Core; (1)

namespace ElasticSearchLogImporter
    class Program
        private static readonly ILog LOGGER = LogManager.GetLogger(typeof(Program));
        static void Main(string[] args) (2)
            XmlConfigurator.ConfigureAndWatch(new FileInfo(AppDomain.CurrentDomain.SetupInformation.ConfigurationFile));
1 This is callout 1
2 This is callout 2


image:url[alt] -- inline version

You can find Linux everywhere these days.

Titled block

  • list with title

  • another item


A person who never made a mistake never tried anything new.
— Albert Einstein
The only code without bugs is the code you never write
— Unknown
I hold it that a little rebellion now and then is a good thing, and as necessary in the political world as storms in the physical.
— Thomas Jefferson
Papers of Thomas Jefferson: Volume 11


An admonition paragraph draws the reader’s attention to auxiliary information. Its purpose is determined by the label at the beginning of the paragraph.
Pro tip…​
Don’t forget…​
Watch out for…​
Ensure that…​
Feeding the Werewolves

While werewolves are hardy community members, keep in mind the following dietary concerns:

  1. They are allergic to cinnamon.

  2. More than two glasses of orange juice in 24 hours makes them howl in harmony with alarms and sirens.

  3. Celery makes them sad.


AsciiDoc history

AsciiDoc was first released in Nov 2002 by Stuart Rackham. It was designed from the start to be a shorthand syntax for producing professional documents like DocBook and LaTeX.


Non interactive checkboxes
  • checked

  • also checked

  • not checked

  • normal list item

Interactive checkboxes
  • checked

  • also checked

  • not checked

  • normal list item

Q & A style

  1. What is Asciidoctor?

    An implementation of the AsciiDoc processor in Ruby.

  2. What is the answer to the Ultimate Question?



header 1 header 2 header 3

Cell in position C1R1

Cell in position C2R1

cell in position C3R1

Cell in position C2R1

Cell in position C2R2

cell in position C3R2

Include content from uri

Use the include macro to pull in a gist inside a source block - like so:


which produces: