.elements-old.adoc 1.15 KB
Newer Older
1
2
3
4
5
6
7
= AsciiDoc Elements

There are two kinds of elements in AsciiDoc, block elements and inline elements.

[#block-element]
== Block elements

8
A [.term]*block element* is stacked vertically (by line) above or below other block elements.
9
10
Block elements are typically referred to simply as [.term]*blocks*.

11
12
13
Examples of blocks include sections, paragraphs, lists delimited blocks, tables, and block macros.
Blocks are easy to identify because they're usually separated from other blocks by a blank line (though not always required).
Some blocks, such as sections and delimited blocks, can nest other blocks inside of them.
14

15
16
17
Every block can have one or more lines of block metadata.
This metadata can be in the form of block attributes, a block anchor, or a block title.
These metadata lines should be directly adjacent to the block itself.
18
19
20
21

[#inline-element]
== Inline elements

22
An [.term]*inline element* performs an operation on a span of content within a <<block-element,block element>>.
23
Inline elements include inline macros such as the icon macro (`icon:[]`) and xref macro (`<< >>`, `xref:[]`), attribute references, and text marked up by inline formatting (italic, bold, etc.).