acerca de HTML

Referencia de etiquetas

Etiqueta dd en HTML: descripciones y valores de dl

La etiqueta <dd> en HTML aporta una descripción, definición o valor a los términos precedentes de un grupo dentro de una lista <dl>. Úsala cuando necesites relacionar un nombre con información sobre él: el nivel de un curso con su valor, una palabra con su significado o un servicio con sus características.

<dl>
  <dt>Nivel</dt>
  <dd>Principiante</dd>
</dl>

El resultado muestra «Nivel» y, debajo, «Principiante», normalmente con sangría. <dt> identifica el nombre del dato y <dd>, su valor.

Sintaxis y contexto válido

Escribe <dd>Contenido</dd> después de un <dt> o de otro <dd> del mismo grupo. Su padre debe ser un <dl> o un <div> que agrupe términos y descripciones y sea hijo directo de <dl>. No es un elemento que puedas colocar suelto dentro de cualquier contenedor.

Cada grupo empieza con uno o más <dt> y continúa con uno o más <dd>. Si usas <div> para envolver los grupos, agrupa así todos los grupos de esa lista: no mezcles grupos envueltos con otros <dt> y <dd> directamente bajo el mismo <dl>. Esas reglas proceden del modelo de contenido de <dl>.

Los ejemplos muestran el cierre </dd> para que sus límites sean claros. En HTML puede omitirse cuando lo sigue inmediatamente otro <dd> o <dt>, o cuando ya no queda contenido en su padre. La apertura no se omite. La sección normativa de <dd> define su contexto y sintaxis.

¿Dd solo puede contener texto?

No. <dd> admite contenido de flujo: además de texto, puedes incluir párrafos, enlaces, listas y otros bloques que cumplan sus propias reglas de anidación. Un <p> dentro de <dd> organiza un párrafo de la descripción; un <ul> organiza varios puntos de ese mismo valor.

Si una explicación ocupa varios párrafos, coloca todos en un único <dd>. Crear un <dd> por párrafo separaría lo que quieres presentar como una sola descripción. Tampoco envuelvas el <dd> en un <p>: la relación se construye dentro de <dl>, y <p> no admite ese elemento.

Varias descripciones para un término

Un término puede tener varios <dd> consecutivos. En un glosario puedes dedicar uno a su definición y otro a un ejemplo de uso, con una etiqueta visible como «Ejemplo:» que aclare la función de cada entrada. Ambos siguen perteneciendo al término anterior.

Cuando aparece un nuevo <dt> después de las descripciones, empieza otro grupo. Por eso dos <dd> seguidos no representan dos registros independientes con nombres distintos. Si necesitas describir otro servicio o concepto, añade primero su propio <dt>. El orden del código debe expresar esa relación incluso sin estilos.

Ejemplo práctico: un glosario para una biblioteca

Guarda este documento como glosario.html con codificación UTF-8 y ábrelo en el navegador. Está completo para esta demostración y no requiere servidor, recursos externos, CSS ni JavaScript.

<!doctype html>
<html lang="es">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Glosario de la biblioteca</title>
  </head>
  <body>
    <h1>Glosario de la biblioteca</h1>
    <dl>
      <dt>Préstamo</dt>
      <dd>
        <p>Entrega temporal de un libro para leerlo fuera de la biblioteca.</p>
        <p>La fecha de devolución figura en el comprobante de cada préstamo.</p>
      </dd>
      <dd>Ejemplo: llevar una novela a casa y devolverla en la fecha indicada.</dd>

      <dt>Material de consulta</dt>
      <dd>
        <p>Obras disponibles para consultar en la sala:</p>
        <ul>
          <li>Diccionarios.</li>
          <li>Atlas.</li>
          <li>Enciclopedias.</li>
        </ul>
      </dd>
    </dl>
  </body>
</html>
  1. Lee «Préstamo» y los dos párrafos de su primer <dd>: juntos forman una descripción. El segundo <dd> añade el ejemplo y sigue asociado a Préstamo.
  2. Continúa con «Material de consulta»: inicia otro grupo. Su <dd> contiene un párrafo y una lista con tres tipos de obras; las viñetas proceden de <ul> y <li>.
  3. Reduce la ventana o abre el archivo en el móvil. Comprueba que cada descripción siga a su término y que sus párrafos y listas se lean completos.

Para probar el ejemplo mínimo, usa el mismo documento y sustituye su <dl> por el bloque de Nivel. Un párrafo puede ir dentro de <dd>, como en el glosario, pero no puede reemplazarlo como hijo directo de <dl>.

Atributos y accesibilidad

<dd> no tiene atributos específicos vigentes. Admite los globales: class sirve para seleccionarlo y aplicar estilos; lang declara el idioma de una descripción cuando difiere del entorno. Ninguno establece la asociación con el término: esa relación la expresa la estructura <dl>–<dt>–<dd>.

Mantén términos comprensibles y el orden de lectura del código. En el glosario, el rótulo «Ejemplo:» distingue esa entrada de la definición sin depender del color o la posición. Conserva la semántica nativa: ARIA en HTML no permite asignar un atributo role a <dd>.

¿Por qué dd aparece sangrado? Errores habituales

La sangría es presentación predeterminada del navegador. Puedes cambiarla mediante CSS, por ejemplo con margin-inline-start: 0, sin alterar el significado de la descripción. El estándar describe los estilos esperados para las listas.

  • Usar <dd> solo para desplazar texto: utiliza CSS sobre un párrafo o contenedor adecuado; reserva <dd> para una asociación real dentro de <dl>.
  • Comenzar la lista con <dd>: falta el término. Añade el <dt> al que corresponde la información.
  • Usar <dt> para el nombre de un campo de formulario: un control necesita <label>; una lista descriptiva no sustituye esa asociación.
  • Convertir cualquier lista en una lista descriptiva: elige <ul> para elementos sin relación nombre–valor y <ol> para una secuencia con orden significativo.

<dl> contiene los grupos, <dt> identifica sus términos y <dd> aporta sus descripciones. <p> y <ul> pueden organizar el contenido interior de una descripción, pero no reemplazan su función en la lista.

Compatibilidad y fuentes

Compatibilidad consultada el 3 de octubre de 2026: MDN clasifica <dd> como ampliamente disponible.

Consulta el HTML Living Standard para significado, grupos y contenido permitido; MDN complementa la explicación y los datos de soporte. El soporte del elemento no garantiza un anuncio idéntico en todas las tecnologías de asistencia.