Section

A section is an organizational division in a topic. Sections are used to organize subsets of information that are directly related to the topic.

Syntax

XDITA

<section>

HDITA

<section>

MDITA (core and extended profiles)

A level-two heading marked by ## or ----- underline

Usage information

Multiple sections within a single topic do not represent a hierarchy, but rather peer divisions of that topic. Sections cannot be nested. Sections can have titles.

Rendering expectations

Processors SHOULD treat the presence of more than one title component in a section component as an error.

Attributes

The available attributes vary based on the authoring format:

XDITA and HDITA
The following attributes are available on this element: ID attributes, localization attributes, universal attributes, and @props.
MDITA
There is no attribute support for the MDITA core profile. For the MDITA extended profile, attributes can be specified by using the HDITA representation.

Examples

This section is non-normative.

Example 1. XDITA example

The following example demonstrates the use of section in an XDITA topic.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD LIGHTWEIGHT DITA Topic//EN" "lw-topic.dtd">
<topic id="franchise-offer">
  <title>What we offer</title>
  <body>
    <p>We offer warranty of territory exclusivity, initial training, and support through online, email, and telephone channels.</p>
    <section id="terms">
      <title>Terms and conditions</title>
      <p>Support is reserved for franchises that are without bills past due payment.</p>
    </section>
  </body>
</topic>
Example 2. HDITA example

The following example demonstrates the use of section in an HDITA topic.

<!DOCTYPE html>
<title>What we offer</title>
<body>
  <article id="franchise-offer">
    <h1>What we offer</h1>
    <p>We offer warranty of territory exclusivity, initial training, and support through online, email, and telephone channels.</p>
    <section id="terms">
      <h2>Terms and conditions</h2>
      <p>Support is reserved for franchises that are without bills past due payment.</p>
    </section>
  </article>
</body>
Example 3. MDITA example

The following example demonstrates the use of section in an MDITA topic.

# What we offer

We offer warranty of territory exclusivity, initial training, and support through online, email, and telephone channels.

## Terms and conditions

Support is reserved for franchises that are without bills past due payment.