How do I apply hierarchy and structure correctly in descriptions?
The editor gives you all the tools you need to create clear and accessible content.
Headings
and Paragraphs
Use the dropdown menu to insert headings and paragraphs.
This has two key advantages:
- It automatically creates a clear visual hierarchy.
- The editor ensures the correct
semantic structure behind the scenes.
Links
Insert links using the link button, or by selecting a word and attaching a URL.
Links are styled automatically so they are easy to distinguish from normal text.
Tables
You can insert tables using the table button:
To set headers, choose a row or a column in the table settings and activate the
header option. Once enabled, you will see the difference visually the headers
are bold and highlighted in grey.
Example Header-Row
Example Header-Column
If needed, both header rows and header columns can be set at the same time.
Lists
The editor supports both ordered (numbers) and unordered (bullet points) lists.
Which one you choose depends on your content. Either way, the editor ensures the lists are semantically correct.
Examples
Below are
two example descriptions showing what these rules look like in practice — one
that follows them and one that breaks them.
"Poor example"
Why this is a poor example?
- A confusing visual hierarchy
- Headings that jump between levels without order
- Speaker overviews shown as unstructured text fragments
- Agendas written as plain paragraphs
- Links
labeled vaguely with “here”
"Good example"
Why is this a good example?
- A clear and consistent heading structure
- Speaker overview presented in a table with a defined header row
- Agenda displayed as an ordered list
- Resources listed in a separate section with short descriptions
- Links with clear, descriptive labels
By consistently using the formatting functions, you ensure that your content is not only visually appealing but also easy to understand and accessible. Follow the good practice example: a clear structure helps readers grasp information quickly and makes navigation easier for both on the page and with assistive technologies.