Markdown Conventions

Apply these conventions when writing, editing, or reviewing markdown files to ensure consistent, readable, and accessible content.

Heading Hierarchy

Use H2 (##) and H3 (###) for document structure. H1 is reserved for the document title (typically generated automatically from metadata or filename) -- never add an H1 inside the body.

If you find yourself reaching for H4 (####) or deeper, that is a signal the document structure is too nested. Restructure by splitting into separate sections or files instead.

## Main Section
Content here.

### Subsection
More detail here.

Lists