# MarkdownReport: формат публичных отчетов

Этот документ фиксирует поддерживаемые блоки публичных Markdown-отчетов Specus.

## Мелкий текст

Мелкий текст предназначен для технических оговорок, библиографии и сносок. Размер, линии, интервалы и цвета задаются централизованно в `app/globals.css` через класс `report_microtext` и его варианты.

### Замечание

```md
:::note
Значения предварительные и требуют проверки для конкретного участка.
:::
```

Использовать для ограничений, статуса проверки, юридических и инженерных оговорок. Один блок должен содержать одну связанную мысль.

### Литература и источники

```md
:::references
<!-- notts:start -->

1. Автор. *Название*. Издатель, год. [Источник](https://example.com/).

<!-- notts:end -->
:::
```

Источники оформляются нумерованным списком. Для книги указываются автор, название, место или издатель и год; для статьи — журнал, том, номер, страницы и DOI; для стандарта — организация, номер и год. Ссылки ведут на DOI, страницу издателя или официальный документ.

### Сноски

```md
:::footnotes
1. Пояснение к термину или числовому значению.
2. Граница применимости утверждения.
:::
```

Сноски используются для коротких пояснений, которые мешают основному ритму текста. Библиографические ссылки следует помещать в `references`.

## Ограничения вложенности

Блоки `note`, `references` и `footnotes` размещаются непосредственно в секции отчета. Их не следует вкладывать внутрь `exhibit`, `media`, `content` или другого контейнера.

## Доступность и озвучивание

Замечания и сноски остаются озвучиваемыми. Библиография, URL и технические выходные данные заключаются между `notts:start` и `notts:end`.