HTML Glossary Markup: Terms, Definitions, and Cross-References

A glossary introduces terms and explains them. A dl with dt and dd shows those pairs without needing a table.

What You Need to Know

If a term needs several descriptions, multiple dd elements can describe the same dt. Keep definitions short and meaningful to beginners.

The goal is not to collect as many tags as possible. Pick the element that best describes what the content really is.

Example: See It in Action

Try this markup in a fresh practice file. The next section explains the parts worth paying attention to.

This is a short HTML fragment. To try it as a webpage, put it inside the body element of a complete HTML document.

<article>
    <h1>Mini Glossary</h1>
    <dl>
        <dt>Element</dt>
        <dd>A piece of HTML content.</dd>
        <dt>Attribute</dt>
        <dd>Extra information inside a start tag.</dd>
    </dl>
</article>

Let’s Understand the Example

• Article marks a piece that could make sense on its own, such as a news post or recipe.
• An h1 introduces the main subject of the page. Use the heading level for structure rather than font size.
• Dl contains terms and their descriptions.

You should see a readable heading and its related content. The heading level tells readers how the ideas fit together, not merely how large the letters look.

What Should You See?

The page should display “Mini Glossary” as a heading, followed by its related content. Change the heading text and refresh the browser to see the result.

Read only the headings, from top to bottom. Do they tell a sensible story? If not, move sections or choose levels that match the content.

Try It Yourself

1. Add the terms Attribute and Browser to the glossary.
2. Save your changes, open or refresh the page, and compare the result with the original example.
3. Tell a friend what your change did. If you are not sure, undo it, refresh the page, and compare.

Common Beginner Mistakes

• Using bold paragraphs instead of matching term and definition markup.
• Avoid picking tags just for their default bold, italic or spaced appearance. Use CSS for presentation.

Key Takeaways

• A glossary introduces terms and explains them.
• Article marks a piece that could make sense on its own, such as a news post or recipe.
• If a term needs several descriptions, multiple dd elements can describe the same dt. Keep definitions short and meaningful to beginners.