Asciidoc feature tour on Blogger

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));
            ConsoleApplication.RunProgram<CommandLineOptions>(Start);
        }
    }
}

1	This is callout 1
2	This is callout 2

Images

image::url[alt]

image:url[alt] -- inline version

You can find everywhere these days.

Titled block

Note

list with title
another item

Quotes

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

Admonitions

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:

They are allergic to cinnamon.
More than two glasses of orange juice in 24 hours makes them howl in harmony with alarms and sirens.
Celery makes them sad.

Sidebars

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.

Checklists

Non interactive checkboxes

checked
also checked
not checked
normal list item

Interactive checkboxes

checked
also checked
not checked
normal list item

Q & A style

What is Asciidoctor?

An implementation of the AsciiDoc processor in Ruby.
What is the answer to the Ultimate Question?

42

Tables

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

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:

include::https://gist.githubusercontent.com/raghur/837ba73ea0e82f59f5cde40941a592a1/raw/e3f3cd6ef7dcd79079e951c1831b38afc21636ec/scalek8sdeployments.sh[]

which produces:

link:https://gist.githubusercontent.com/raghur/837ba73ea0e82f59f5cde40941a592a1/raw/e3f3cd6ef7dcd79079e951c1831b38afc21636ec/scalek8sdeployments.sh[]