# \startsection ... \stopsection

## Summary

The instances of \startsection ... \stopsection are used for wrapping a section text in an environment and typesetting its title.

## Instances

 \startpart ... \stoppart highest level of sectioning \startchapter ... \stopchapter level 2 \startsection ... \stopsection level 3 \startsubsection ... \stopsubsection level 4 \startsubsubsection ... \stopsubsubsection level 5 \startsubsubsubsection ... \stopsubsubsubsection level 6 \startsubsubsubsubsection ... \stopsubsubsubsubsection level 7 \starttitle ... \stoptitle level 2, unnumbered \startsubject ... \stopsubject level 3, unnumbered \startsubsubject ... \stopsubsubject level 4, unnumbered \startsubsubsubject ... \stopsubsubsubject level 5, unnumbered \startsubsubsubsubject ... \stopsubsubsubsubject level 6, unnumbered \startsubsubsubsubsubject ... \stopsubsubsubsubsubject level 7, unnumbered

## Settings instance

 \startSECTION[...=...,...][...=...,...] ... \stopSECTION title text bookmark text marking text list text reference reference ownnumber text placeholder text key value

OptionExplanation
The first argument defines the visible and cross-referencing properties of the section.
title
 is the title that will be used to create the section heading. Alternative versions of the title may also be specified, as explained below. The main title is used if these are not specified. If you need a line break in a title, you can use \\, it will create a line break on location, but a space in list and marking context. Unfortunately it will appear literally in PDF bookmarks.
bookmark
 is used in PDF bookmarks, if enabled (see \setupinteraction and \placebookmarks).
marking
 is used in headers and footers.
list
reference
 specifies the reference-key for use with cross-referencing commands (see \at and \in).
ownnumber
 a sectioning number to use instead of the calculated one.
The second, optional, argument allows section-local user-variables to be assigned. The values of these variables can be recalled with the \structureuservariable command.

## Description

This family of commands are only available in ConTeXt MkIV. They supersede the sectioning commands \part, \chapter, \section, \subsection, \subsubsection, \title, \subject, \subsubject, and \subsubsubject.

The new commands, collectively documented here, are \startpart, \startchapter, \startsection, \startsubsection, \startsubsubsection, \starttitle, \startsubject, \startsubsubject, and \startsubsubsubject. These more verbose commands apply an environment (\start- and \stop-) approach to sectioning, which is more friendly to tagged-PDF, ePUB and XML output.

Sectioning is hierarchical. Numbered parts are divided into numbered chapters, themselves divided into numbered sections, subsections, and subsubsections etc. Chapters and sections etc. have unnumbered counterparts called titles, subjects, subsubjects, and subsubsubjects etc., respectively. (There are actually a couple more sub-levels than listed here.) Chapters start a new page (by default—this is easily configurable). Parts are unusual in two respects: firstly, there is no unnumbered counterpart to parts; and secondly, the title of a part is not typeset automatically, as it will generally require special attention and design.

Additional section types can be defined (based on one of the existing sections) with the \definehead command. A user-defined section type will have its own \start- and \stopsection commands, in addition to a traditional \section command. These new commands will behave as documented here

The typesetting of section types (both built-in and user-defined) can be controlled with the \setupheads and \setuphead commands.

## Examples

### Example 1

\setuppapersize[A6,landscape]
\starttext

\startsection[
reference=sec:One,
title={Section One},
]

For a subsection, see \in{subsection}[sec:Two:Sec].

\stopsection

\startsection[
reference=sec:Two,
title={Section Two},
]
[a_variable={some value}]

a_variable=\quote{\structureuservariable{a_variable}}.

\startsubsection[
reference=sec:Two:Sec,
title={Here’s a subsection},
]

In this subsection there’s some text\ldots

\stopsubsection
\stopsection
\stoptext


produces

### Example 2

\setuppapersize[A6,landscape]
\starttext

\startpart[title={Part}]
\startchapter[title={Chapter}]
\startsection[title={Section}]
\startsubsection[title={Subsection}]
\startsubsubsection[title={Subsubsection}]
\startsubsubsubsection[title={Subsubsubsection}]
\startsubsubsubsubsection[title={Subsubsubsubsection}]

\stopsubsubsubsubsection
\stopsubsubsubsection
\stopsubsubsection
\stopsubsection
\stopsection
\stopchapter
\stoppart
\stoptext


produces