Правила валидатора
Кнопка «Проверить» в редакторе прогоняет документ по каталогу ниже.
Сейчас в каталоге 39 правил. Проверка бесплатна
и не списывает генерацию.
Не обещаем «70+»: число совпадает с кодами в исходниках валидатора.
Структура работы
| Код | Что ломается | Как исправить в Markdown |
|---|
SCHEMA_INVALID | Документ не проходит схему: сломана структура YAML/Markdown. | Исправьте разметку по шпаргалке: заголовки `#` / `##` / `###`, таблицы `|`, формулы `$`. |
REQUIRED_MISSING | В разделе нет обязательного элемента (например, ключевых слов в реферате). | Добавьте недостающий блок: для ключевых слов — абзац с подтипом keywords. |
RESTRICTED_IN_SECTION | В разделе стоит элемент, который стиль запрещает (таблица во введении и т. п.). | Уберите элемент из раздела или смените тип раздела. |
APPENDIX_LETTER_INVALID | Буква приложения из запрещённого набора Ё, З, Й, О, Ч, Ъ, Ы, Ь (ГОСТ 7.32 п. 6.17.4). | Поставьте другую букву: `# Приложение А`. |
APPENDIX_OVERFLOW | Больше 25 приложений — допустимые литеры ГОСТ исчерпаны. | Объедините приложения или вынесите лишнее в основной текст. |
Идентификаторы и ссылки
| Код | Что ломается | Как исправить в Markdown |
|---|
ID_DUPLICATE | Одинаковый `{#id}` у двух объектов — ссылки неоднозначны. | Дайте каждому объекту уникальный ключ: `{#tbl_1}` и `{#tbl_2}`. |
REF_UNRESOLVED | Ссылка `{ref:id}` не находит цель. | Поставьте тот же ключ на таблицу, рисунок или формулу: `: Название {#id}`. |
MENTION_MISSING | Таблица или рисунок появляются без отсылки в тексте до них (п. 6.5.1 / 6.6.2). | До объекта напишите: «данные приведены в {ref:tbl_1}». |
MANUAL_NUMBERING | В тексте стоит ручной номер «Рисунок 5» / «Таблица 3» вместо автоссылки. | Замените на `{ref:fig_id}` — номер подставит сборка. |
SHEET_OF_UNRESOLVED | Лист-продолжение рисунка ссылается на несуществующий первый лист. | В `{sheet_of=id}` укажите ключ первого листа рисунка. |
Таблицы
| Код | Что ломается | Как исправить в Markdown |
|---|
TABLE_ID_MISSING | Таблица без ключа `{#id}` — на неё нельзя сослаться. | Под таблицей: `: Название {#tbl_x}` (название можно опустить: `: {#tbl_x}`). |
TABLE_NAME_MISSING | Таблица без названия (ГОСТ 7.32 п. 6.6). | Добавьте `: Сравнение показателей {#tbl_x}` над/под таблицей в диалекте. |
TABLE_EMPTY_CELL | Пустая ячейка без прочерка «–». | Поставьте «–» в пустых ячейках. |
TABLE_TOO_SMALL | Таблица меньше 2 граф или 2 строк (ГОСТ Р 2.105 п. 6.8.1). | Таблица должна содержать не менее двух граф и двух строк. |
Рисунки и диаграммы
| Код | Что ломается | Как исправить в Markdown |
|---|
CAPTION_MISSING | Рисунок без подписи (п. 6.5.7). Лист-продолжение своей подписи не требует. | Пишите `{#fig_x}`. |
DIAGRAM_INVALID | Диаграмма Mermaid/PlantUML не отрендерилась или блок пустой. | Проверьте синтаксис внутри ` ```mermaid ` / ` ```plantuml ` и закройте блок. |
Формулы
| Код | Что ломается | Как исправить в Markdown |
|---|
FORMULA_INVALID | Формула не компилируется из LaTeX в OMML. | Проверьте синтаксис: `$ E = mc^{2} $ {#eq_1}`. |
Источники
| Код | Что ломается | Как исправить в Markdown |
|---|
CITE_UNRESOLVED | Цитата `[@ключ]` без записи в списке источников. | В разделе источников добавьте `- {#ключ} Иванов, А. Б. … — …`. |
SOURCE_UNMENTIONED | Запись с ключом есть в списке, но в тексте на неё нет `[@ключ]` (п. 6.16). | Сошлитесь `[@ключ]` в тексте или удалите лишнюю запись. |
SOURCES_TOO_FEW | В списке меньше источников, чем требует стиль (в ГОСТ 7.32 — обычно 15). | Добавьте записи или ослабьте `min_sources` в стиле кафедры. |
BIB_FORMAT | Запись не похожа на ГОСТ Р 7.0.100: APA, markdown-ссылка, нет тире «—», нет URL/даты у сайта. | Вставьте запись через «Вставка → Запись источника» или оформите области через «. — ». |
Объём разделов
| Код | Что ломается | Как исправить в Markdown |
|---|
ABSTRACT_TOO_LONG | Реферат длиннее лимита стиля (по умолчанию 2400 знаков). | Сократите реферат; статистику и ключевые слова оставьте. |
ABSTRACT_VERBOSE | Реферат длиннее мягкого порога (по умолчанию 1800 знаков). | Сожмите формулировки, пока не уложитесь в порог стиля. |
INTRODUCTION_TOO_LONG | Введение длиннее лимита стиля (по умолчанию 6000 знаков). | Оставьте цель, задачи, актуальность, объект и предмет — уберите лишний обзор. |
INTRODUCTION_VERBOSE | Введение длиннее мягкого порога (по умолчанию 5000 знаков). | Сократите обзор литературы — ему место в основной части. |
CONCLUSION_TOO_LONG | Заключение длиннее лимита стиля (по умолчанию 6000 знаков). | По одному выводу на задачу введения, без нового материала. |
CONCLUSION_VERBOSE | Заключение длиннее мягкого порога (по умолчанию 4000 знаков). | Уберите пересказ глав — оставьте выводы и перспективы. |
KEYWORDS_COUNT | Число ключевых слов вне нормы стиля (обычно 5–15). | Перечислите слова через запятую в абзаце ключевых слов. |
COUNTER_ABBREV | В строке статистики реферата сокращения «с.», «рис.», «табл.». | Пишите полностью: страниц, рисунков, таблиц, источников, приложений. |
Рамка и шрифт
| Код | Что ломается | Как исправить в Markdown |
|---|
FRAME_MARGINS_OVERLAP | Поля страницы с рамкой ГОСТ 2.104 налезают на линию рамки или штамп. | Увеличьте поля в конструкторе стиля или выберите профиль с рамкой. |
FONT_UNAVAILABLE | Шрифт из стиля не установлен на сервере — сборка подменит его на Times New Roman. | Выберите шрифт из списка в конструкторе стиля. |
Разметка Markdown
| Код | Что ломается | Как исправить в Markdown |
|---|
SEMICOLON_IN_PROSE | Точка с запятой в обычном абзаце — похоже на сплющенный список (п. 6.4.6). | Оформите перечисление списком `-` после двоеточия или через запятые и «и». |
UNKNOWN_CONTAINER | Контейнер `:::имя` не поддерживается — содержимое пошло как обычный текст. | Используйте известные блоки: `::: where`, `::: frame` и другие из шпаргалки. |
UNKNOWN_ATTR | Атрибут в `{…}` не распознан и не применён. | Оставьте известные: `{#id}`, `{ref:…}`, `{sheet_of=…}`, `width=`. |
UNPARSED_BLOCK | Строка похожа на разметку, но не разобрана и попала как текст. | После `#` нужен пробел; заголовки глубже `###` не поддерживаются. |
TEXT_BEFORE_HEADING | Текст до первого заголовка `#` отброшен. | Перенесите абзац под заголовок раздела. |
UNCLOSED_BLOCK | Не закрыты `:::`, ` ``` ` или `$` — хвост документа попал внутрь блока. | Закройте блок той же строкой: `:::`, ` ``` ` или `$`. |
UNKNOWN_FRAME_FIELD | В таблице `::: frame` неизвестная графа штампа — значение потеряно. | Используйте графы из шпаргалки рамки (Разраб., Пров., Наименование…). |
FRAME_FIELD_ABSENT | Графа есть в диалекте, но её нет в поставляемой форме рамки — в штамп не попадёт. | Уберите строку или перенесите значение в другую графу формы. |
Частые вопросы
Сколько правил проверяет валидатор? Столько, сколько кодов
в каталоге на этой странице.
Что проверяем бесплатно? Проверка валидатором, предпросмотр
разделов, конструктор стиля и черновик в браузере — в том числе без регистрации.
Блокирует ли замечание сборку? Только уровень «Ошибка».
Замечания ГОСТ документ не блокируют.
Как пользоваться проверкой — в инструкции.