title
===============================================================================
%% Titles define the structure of a Mechdown document and drive generated navigation such as the table of contents.
Mechdown supports hierarchical titles:
- **Document title**: the file's top heading
- **Section titles**: numbered headings such as `1. Section`
- **Subsection titles**: headings such as `(1.1) Subsection`
- **Sub-subsection titles**: headings such as `(1.1.1) Topic`
1. Rules and conventions
-------------------------------------------------------------------------------
- Use one document title per file. The document can have an optional byline (author, date, etc.) immediately following the title.
- Keep section numbering sequential.
- Keep subsection numbering aligned with the parent section.
- Prefer short, descriptive titles so generated navigation remains readable.
2. Examples
-------------------------------------------------------------------------------
```
Mechdown Title Guide
===============================================================================
1. Section Title
-------------------------------------------------------------------------------
(1.1) Subsection Title
(1.1.1) Sub-subsection Title
```
Section and first-level subsection titles are included in the generated table of contents.
To add a byline, place it immediately after the title and conclude with a second `===` separator:
```
My Document
===============================================================================
By Mika the Mech
===============================================================================
```