--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://3y3.dev/en/project/lint.md - https://3y3.dev/ru/project/lint.md - href: ru/project/lint.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt updatedAt: '2026-08-06T11:19:50.000Z' --- > **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt # Файл конфигурации линтера В корне проекта можно разместить файл конфигурации линтера `.yfmlint` для управления проверками сборки документации. Значения настроек по умолчанию: ```yaml log-levels: MD001: 'disabled' # Heading levels should only increment by one level at a time MD002: 'disabled' # First heading should be a top-level heading~~ MD003: 'disabled' # Heading style MD004: 'disabled' # Unordered list style MD005: 'disabled' # Inconsistent indentation for list items at the same level MD006: 'disabled' # Consider starting bulleted lists at the beginning of the line~~ MD007: 'disabled' # Unordered list indentation MD009: 'disabled' # Trailing spaces MD010: 'disabled' # Hard tabs MD011: 'disabled' # Reversed link syntax MD012: 'disabled' # Multiple consecutive blank lines MD013: 'disabled' # Line length MD014: 'disabled' # Dollar signs used before commands without showing output MD018: 'error' # No space after hash on atx style heading MD019: 'disabled' # Multiple spaces after hash on atx style heading MD020: 'disabled' # No space inside hashes on closed atx style heading MD021: 'disabled' # Multiple spaces inside hashes on closed atx style heading MD022: 'disabled' # Headings should be surrounded by blank lines MD023: 'disabled' # Headings must start at the beginning of the line MD024: 'disabled' # Multiple headings with the same content MD025: 'disabled' # Multiple top-level headings in the same document MD026: 'disabled' # Trailing punctuation in heading MD027: 'disabled' # Multiple spaces after blockquote symbol MD028: 'disabled' # Blank line inside blockquote MD029: 'disabled' # Ordered list item prefix MD030: 'disabled' # Spaces after list markers MD031: 'disabled' # Fenced code blocks should be surrounded by blank lines MD032: 'disabled' # Lists should be surrounded by blank lines MD033: 'disabled' # Inline HTML MD034: 'disabled' # Bare URL used MD035: 'disabled' # Horizontal rule style MD036: 'disabled' # Emphasis used instead of a heading MD037: 'disabled' # Spaces inside emphasis markers MD038: 'disabled' # Spaces inside code span elements MD039: 'disabled' # Spaces inside link text MD040: 'disabled' # Fenced code blocks should have a language specified MD041: 'disabled' # First line in a file should be a top-level heading MD042: 'disabled' # No empty links MD043: 'disabled' # Required heading structure MD044: 'disabled' # Proper names should have the correct capitalization MD045: 'disabled' # Images should have alternate text (alt text) MD046: 'disabled' # Code block style MD047: 'disabled' # Files should end with a single newline character MD048: 'disabled' # Code fence style YFM001: 'warn' # Inline code length YFM002: 'warn' # No header found in the file for the link text YFM003: 'error' # Link is unreachable YFM004: 'error' # Table not closed YFM005: 'warn' # Tab list, cut, note not opened or closed YFM006: 'warn' # Term definition duplicated YFM007: 'warn' # Term used without definition YFM008: 'warn' # Term inside definition not allowed YFM009: 'error' # Term definition used not at the end of file YFM010: 'warn' # Autotitle anchor is missed YFM011: 'warn' # Max svg size YFM012: 'error' # Max output html size YFM013: 'error' # Max single asset size YFM014: 'warn' # Anchor cannot be used as file path YFM015: 'warn' # Anchor not found in file YFM016: 'error' # The file is included in itself YFM017: 'error' # Invalid front matter format: duplicated mapping key YFM018: 'info' # Term definition from include YFM020: 'warn' # Invalid yfm directive YFM021: 'warn' # Non-BMP (UTF-16 surrogate pair) character YFM022: 'info' # llms-full.txt max size reached # Inline code length YFM001: maximum: 100 ``` Правила с префиксом `MD` предоставляются библиотекой [markdownlint](https://github.com/DavidAnson/markdownlint). Подробное описание всех правил с префиксом `MD` можно найти [по ссылке](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md). Подробное описание всех правил с префиксом `YFM` можно найти [по ссылке](https://github.com/diplodoc-platform/yfmlint/blob/master/README.md). Вы можете переопределить уровень логирования в файле `.yfmlint` в секции `log-levels` отдельно для каждого правила: `error`, `warn`, `disabled`. {% note warning %} Нельзя переопределить ошибки `YFM014`, `YFM015`, `YFM016` и `YFM017`. {% endnote %} В корневой секции можно настроить значения, передаваемые правилам. Например: ```yaml # Inline code length YFM001: level: warn maximum: 100 # Supported yfm directives YFM020: level: warn customDirectives: - diagram # skip warning on {% diagram %} directive # Line length MD013: line_length: 100 # default: 80 characters code_blocks: false # exclude this rule for code_blocks tables: false # exclude this rule for tables headings: false # exclude this rule for headings # Inline HTML MD033: allowed_elements: [ "span", "br", "p" ] # Section for defining log levels log-levels: ``` Исходные значения для правил с префиксом `MD` указаны [по ссылке](https://github.com/DavidAnson/markdownlint/blob/main/schema/.markdownlint.yaml). Исходные значения для правил с префиксом `YFM` указаны [по ссылке](https://github.com/diplodoc-platform/yfmlint/blob/master/src/config.ts). Правила можно включить, выключить, настроить для всего файла или абзаца в файле. Примеры можно посмотреть [по ссылке](https://github.com/DavidAnson/markdownlint/blob/a852407c887ec60949aa5365ed964bab833f962f/README.md#configuration). > Смотри также: [Ajv схема файлов конфигурации линтера .yfmlint](https://raw.githubusercontent.com/diplodoc-platform/ajv/refs/heads/master/src/json/yfmlint-schema.json)