asciidoctor
Learn Asciidoctor syntax for writing documents. Convert plain text to structured documents with headers, lists, links, images, tables, and code blocks.
Asciidoctor Syntax Guide
This page provides a comprehensive guide to Asciidoctor syntax, a powerful markup language for writing documents, books, and articles. Asciidoctor allows you to convert plain text into structured, well-formatted documents with ease.
Document Structure and Headers
Asciidoctor uses a simple syntax for defining document structure, including headers of different levels. The primary keyword for this section is "document structure".
= Document Title (H1)
Author Name
:toc:
:icons: font
== Section Title (H2)
Content for the H2 section.
=== Subsection Title (H3)
Content for the H3 subsection.
Blocks and Content Formatting
Learn how to format various content blocks, including quotes, notes, warnings, and more. This section focuses on "content formatting" within Asciidoctor.
[quote, Author, Source]
____
This is a block quote.
____
NOTE: This is an informational note.
[WARNING]
====
This is a warning block.
====
This is a paragraph.
Lists and Tables
Asciidoctor supports rich list types (ordered, unordered, description) and powerful table creation. Key terms here are "list syntax" and "table formatting".
.Unordered List
* Item 1
** Sub-item 1.1
- Item 2
.Ordered List
. First item
. Second item
Description list item:: Definition for the item.
.Table Example
|===
| Header 1 | Header 2
| Row 1 Col 1 | Row 1 Col 2
| Row 2 Col 1 | Row 2 Col 2
|===
Links, Images, and Code
Incorporate external and internal links, embed images, and include code snippets with syntax highlighting. This covers "link creation", "image embedding", and "code blocks".
// Links
Automatic link: http://example.com
Link with title: http://example.com[Example Website]
Relative link: link:../README.adoc[README]
// Images
image:image.png[Alt text]
.Block Image Title
image::image.jpg[Alt text, 300, 200]
// Code Blocks
....
This is a literal block.
....
[source,python]
----
print("Hello, Asciidoctor!")
----
Advanced Formatting and Includes
Explore advanced formatting options like bold, italic, monospace, and how to include content from other files. This section highlights "advanced formatting" and "content inclusion".
*bold*, _italic_, `monospace`
[blue]
This text is blue.
include::another_file.adoc[]
External Resources
For more in-depth information and advanced usage, refer to the official Asciidoctor documentation and related resources.