Work with headings and section titles

Use section titles and headings to structure content in Tangelo documents. Although they may look similar in the final output, they serve different purposes and are managed in different locations.

Section titles are defined in the document structure and form the hierarchy of the document. They are typically used to create chapters, sections, and subsections that can be included in the table of contents.

Headings are added within the content of a section using the editor. They help organise longer sections by creating additional structure within the text without affecting the document hierarchy.

This distinction allows you to build the document structure to the level required for navigation and the table of contents, while still using headings within sections to improve readability.

Summary

After completing these steps, you can create headings within a section and understand when to use section titles versus headings.

Steps

Create a Section Title

1. Open the document structure.
2. Create a new section or select an existing section.
3. Enter or modify the section title in the document structure.
4. Save the changes if required.

The section title becomes part of the document hierarchy and can be used in navigation, references, and tables of contents.

Create a Heading Within a Section

1. Open a section in the editor.
2. Enter the text that should become a heading.
3. Select the paragraph containing the text.
4. Open the Start menu.
5. Select the appropriate heading style.
   • Heading 1
   • Heading 2
   • Heading 3
   • Other configured heading levels
6. Continue entering content below the heading.

Expected Result

The document contains a structured hierarchy of section titles, while headings provide additional structure within the content of individual sections.

Remarks

• Section titles are managed in the document structure, not in the editor.
• Headings are created within a section using the editor.
• Section titles and headings must be configured before they receive their final styling.
• In many document templates, a chapter section title uses the same styling as Heading 1, but this is not mandatory and depends on the document design.
• Section titles can be included in automatically generated tables of contents.
• Headings cannot be included in automatically generated tables of contents.
• Section links and cross-references can only be created to section titles.
• Headings cannot be used as link targets for section references.
• Use section titles to create the document hierarchy and use headings to structure content within a section.

Walkthrough

A visual step-by-step walkthrough is included below to guide you through creating section titles and headings.