~~~~~~~~

<section id="docbook">
 <title>Using DocBook</title>
 <simpara>
  As DocBook is an XML format, opening and closing tags
  must match (&lt;tag&gt;...&lt;/tag&gt;).
 </simpara>
 <section id="inline">
  <title>Text Formatting</title>
  <simpara>
   A simple paragraph.
  </simpara>
  <para>
   A complex paragraph may contain blocks.
  </para>
  <simpara>
   italics: <emphasis>italics</emphasis>,
   bold: <emphasis role="strong">bold</emphasis>,
   strikeout: <emphasis role="strikethrough">strikeout</emphasis>,
   inline code snippets: <literal>inline code</literal>.
  </simpara>
  <simpara>
   Links:
   <ulink url="http://foo.bar/baz">external</ulink>,
   <ulink url="Pagename">internal Wiki Link</ulink>.
  </simpara>
  <simpara>
   Inserting an image:
   <inlinemediaobject>
    <alt>folder</alt>
    <imageobject>
     <imagedata fileref="/img/icons/folder.png" />
    </imageobject>
   </inlinemediaobject>
  </simpara>
 </section>
 <section id="blocks">
  <title>Text Blocks</title>
  <para>
   Quotation:
   <blockquote>
    <simpara>
     A quotation set off from the main text.
    </simpara>
   </blockquote>
  </para>
  <para>
   Code listing:
   <programlisting>
#!/bin/sh -e
echo &quot;Hello world&quot;
   </programlisting>
  </para>
 </section>
 <section id="lists">
  <title>Lists</title>
  <para>
   Simple list:
   <itemizedlist spacing="compact">
    <listitem>
     <simpara>
      first
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      second
     </simpara>
    </listitem> 
   </itemizedlist>
   Numbered list:
   <orderedlist spacing="compact">
    <listitem>
     <simpara>
      first
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      second
     </simpara>
    </listitem> 
   </orderedlist>
   Definition list:
   <variablelist>
    <varlistentry>
     <term>
      DocBook
     </term>
     <listitem>
      <simpara>
       A sophisticated XML format.
      </simpara>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term>
      orange
     </term>
     <listitem>
      <simpara>
       A healthy fruit.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       A warm colour.
      </simpara>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </section>
</section>
 
~~~~~~~~

Further reading:
[DocBook 5: The Definitive Guide](https://tdg.docbook.org/tdg/5.0/docbook.html),
which includes the
[List of DocBook elements](https://tdg.docbook.org/tdg/5.0/chunk-part-d64e8789.html).
