Welcome!

Hello there. This repo serves as my demo for Antora and asciidoc. It’s also my first repo on Gitlab.

I’ll include the asciidoc-demo page here in case you’d like to learn about the advantages of Asciidoc.

Enjoy!

Asciidoc Demo

Here are some things Asciidoc can do that Markdown cannot:

Hard line breaks

A `+` at the end of a line will create a hard line break.

First line
Second line
Third line

--OR--

Add `[%hardbreaks]` to the beginning of a block to create hard line breaks within the block.

First line
Second line
Third line

Literal paragraphs

Add one or more spaces to the beginning of a line to create a literal paragraph.

Normal paragraph first line

Literal paragraph first line
Literal paragraph second line
You can also add the [literal] attribute to a block to create a literal paragraph.
Literal paragraph first line
Literal paragraph second line

Lead paragraphs

Add the [lead] attribute above a block to create a lead paragraph, which stands out from the rest of the text.

This is a lead paragraph.

This is a normal paragraph.

To add a title above a block, add a period followed by text (e.g. `.Title for this block`).

Block titles

Title for this block
  • Thing

  • Other thing

  • Yet another thing

Sidebars

To create a sidebar, which draws a border around text, added four asterisks `****` above the block and four asterisks `****` below the block. Note that you may want to add a title to the block as seen above using `.Title for block.
Some Title

stuff

Includes

To include content from another page in the current page, use the syntax `include::name_of_file_to_include.adoc[]`.

For example: if the file to include is named 'included' and is in the same directory as the current file, the include would look like: `include::included.adoc[]`

Inclusion Demo

I was pulled in by an inclusion!