# `MD041` - A primeira linha do arquivo deve ser um título de nível superior

Tags: `headings`

Aliases: `first-line-h1`, `first-line-heading`

Parâmetros:

- `allow_preamble`: valor de configuração (`boolean`, padrão `false`)
- `front_matter_title`: valor de configuração (`string`, padrão `^\s*title\s*[:=]`)
- `level`: valor de configuração (`integer`, padrão `1`)

## Visão geral

A primeira linha do arquivo deve ser um título de nível superior. Esta regra ajuda a manter documentos Markdown consistentes, legíveis e fáceis de manter.

## Configuração

Use as chaves de configuração listadas acima para ajustar o comportamento desta regra.

## Exemplos

```markdown
This is a document without a heading
```

```markdown
# Document Heading

This is a document with a top-level heading
```

```markdown
<h1 align="center"><img src="https://placekitten.com/300/150"/></h1>

This is a document with a top-level HTML heading
```

```markdown
This is a document with preamble text

# Document Heading
```

## Motivo

Uma escrita consistente reduz o custo de leitura e manutenção e torna a automação mais confiável.
