Basic Document

What it demonstrates: All common AsciiDoc elements in a single file — headings, text formatting, lists, tables, code blocks, admonitions, blockquotes, and cross-references.

Who it’s for: Anyone new to AsciiDoc or libasciidoc who wants to see what’s supported.

Run It

Convert to HTML:

ascii2html examples/basic/document.adoc
open examples/basic/document.html

Or generate a Word document:

ascii2doc examples/basic/document.adoc

Source

examples/basic/document.adoc

Here is a snippet from the source showing some of the elements:

== Attributes

AsciiDoc attributes let you define reusable values once and reference them throughout the document. This document uses:

* `project-name` = {project-name}
* `project-version` = {project-version}
* `project-url` = {project-url}

Change the values in the header and every reference updates automatically. This is useful for version numbers, product names, URLs, and any other value that appears in multiple places.

== Text Formatting

This is a normal paragraph. You can use *bold*, _italic_, *_bold italic_*, `monospace`, and #highlighted# text. You can also use ^superscript^ and ~subscript~.

== Lists

=== Unordered

* First item
* Second item
** Nested item
** Another nested item