Headings in TDX knowledge base articles

Summary

How to create accessible headings in TDX knowledge base articles

Body

Use headings in an article or service description when needed to organize the information into sections for clarity and readability. Put the most important information at the beginning of each heading. 

Use HTML heading tags for all headings. 

Heading 1 should not be used in TDX articles and service descriptions; heading 2 will be the highest level used in the Body or Long Description. Article Subject fields and service Name fields are rendered with Heading 1 (H2) tags, so the main headings within the article Body field or service Long Description field should be Heading 2. Headings beneath those should be Heading 3 and so on. 

Don't skip headings; use them in descending order.

Descriptive headings are important for ADA accessibility as they help to find specific content and become oriented in the page. The requirement for Level AA is that headings must describe the topic or purpose, but for Level AAA, section headings must be used to organize the content of the page. To ensure web accessibility, see W3C's pages on:

Create a heading in a knowledge base article or service description

Editor toolbars with Paragraph Format dropdown default displaying "Normal"), and the heading levels that can be selected

In the TDX editor, click into the heading text, click the Paragraph Format dropdown (default displays "Normal"), and select the heading level.

Microsoft Writing Style Guide: Headings

Details

Details

Article ID: 2090
Created
Thu 7/23/26 11:57 PM
Modified
Fri 7/24/26 12:52 AM
Audience
Faculty
Staff
Type of user
Use this to define the type of user that would find this article useful. Example: "Faculty submitting grades" or "People who work with reporting."
Faculty or staff who are creating TDX knowledge base articles