The <alt> element provides alternate text for an image. It is
equivalent to the @alt attribute on the <image>
element; since the @alt attribute is deprecated, use the
<alt> element instead. The <alt> element
can be more easily edited or translated than the @alt attribute.
A <dl> element is a list of terms and corresponding definitions.
The term (<dt>) is usually flush left. The description or definition
(<dd>) is usually either indented and on the next line, or on the same line
to the right of the term. However, actual rendering is up to the rendering
The <dlhead> element contains optional headings for the term and
description columns in a definition list (<dl>). The definition list
heading might contain a heading for the column of terms
(<dthd>) and a heading for the column of descriptions
The <draft-comment> element is designed to facilitate review and
discussion of topic contents within the marked-up content. Use the
<draft-comment> element to ask a question or to make a comment that you
want others to review. To indicate the source of the draft comment or the status of
use the @author, @time, or @disposition
The <fig> element is a figure (sometimes called an "exhibit")
with an optional title for a wide variety of content. A figure commonly contains an
artwork, but it can contain several kinds of text objects as well. A title is placed
figure to provide a caption that describes the content.
The <figgroup> element is used primarily for specialization, in
order to create segments within a figure. The element can nest
itself, which allows it to create complex specialized structures (such as the nestable
syntax within a syntax diagram). Figure groups can be used to contain multiple cross-references,
footnotes or keywords.
A <li> element is a single item in an ordered
(<ol>) or unordered (<ul>) list. When a
DITA topic is rendered, numbers and alpha characters are typically displayed with
in ordered lists, while bullets and dashes are typically displayed with list items
The <lines> element contains text where line breaks are
significant but white space is not. It can be used to represent dialogs, poetry, or
fragments where line breaks are significant. The <lines> element is
similar to <pre> in that line breaks are preserved, but the font style is
not typically set to monospace, and extra spaces inside the lines are not preserved.
The <lq> is used to provide extended content quoted from another
source. Use the quote element <q> for short, inline quotations, and long
quote <lq> for quotations that are too long for inline use, following
normal guidelines for quoting other sources. The @href and
@keyref attributes are available to specify the source of the quotation.
The <longquoteref> element is available for more complex references
to the source of a quote.
The DITA <object> element corresponds to the
HTML <object> element, and attribute semantics derive from their
HTML definitions. For example, the @type attribute differs from the
@type attribute on many other DITA elements.
The <param> (parameter) element specifies a set of values that might be required by an <object> at runtime.
Any number of <param> elements might
appear in the content of an <object> in any order, but must be placed at
the start of the content of the enclosing object. This element is comparable to the
<param> element, and its attributes' semantics derive from their HTML
definitions. For example, the @type attribute differs from the
@type attribute on many other DITA elements.
The <ph> element is used to enclose a phrase for reuse or
conditional processing (for example, when part of a paragraph applies to a particular
can be used by specializations of DITA to create semantic markup for content at the
which then allows (but does not require) specific processing or formatting.
The <pre> element contains text for which all line breaks and
spaces are preserved. It is typically presented in a monospaced font. Do not use
<pre> when a more semantically specific element is appropriate, such as
The <q> element includes content quoted from another source. This
element is used for short quotes that are displayed inline. Use the long quote element
for quotations that should be set off from the surrounding text or that contain multiple
The <section> element represents an organizational division in a
topic. Sections are used to organize subsets of information that are directly related
topic. Multiple <section> elements within a single topic do not represent
a hierarchy, but rather peer divisions of that topic. Sections cannot be nested. A
<section>can have an optional title.
The <sectiondiv> element allows logical grouping of content within
a section. There is no additional meaning associated with the
<sectiondiv> element. The <sectiondiv> element
does not contain a title; the lowest level of titled content within a topic is the
itself. If additional hierarchy is required, use nested topics
instead of the section.
The <sli> element is an item in a simple list (<sl>).
Simple list items have phrase or text content, adequate for describing
package contents, for example. When a DITA topic is formatted for
output, the items of a simple list should be placed each on its own
line, with no other prefix such as a number (as in an ordered list)
or bullet (as in an unordered list).
The <text> element associates no semantics with its content. It
exists to serve as a container for text where a container is needed (for example,
as a target
for content references, or for use within restricted content models in
Use the <xref> element to provide an inline cross reference. It is
commonly used to link to a different location within the current topic, a different
a specific location in another topic, or an external resource. The target of the
cross-reference is specified using the @href or @keyref