Проверка стиля и lint Markdown

Проверяет Markdown по ~15 правилам markdownlint плюс 2 правилам китайской типографики, с отчётом по строкам и авто-исправлением безопасных проблем

Вставьте Markdown и получите отчёт о качестве содержания — не структурное преобразование. Проверщик разбивает документ на блоки (заголовки, списки, код-заборы, таблицы…) и запускает движок правил по мотивам markdownlint:

Правила markdownlint:

  • MD001 приращение заголовков (без пропусков)
  • MD003 / MD006 стиль и размещение заголовков
  • MD004 согласованность маркеров списков
  • MD009 конечные пробелы
  • MD012 несколько пустых строк подряд
  • MD013 длина строки (строго)
  • MD022 / MD031 / MD032 пустые строки вокруг заголовков, код-заборов, списков
  • MD024 дубликаты заголовков
  • MD025 один h1
  • MD029 префикс упорядоченного списка
  • MD040 язык в код-заборе
  • MD041 первая строка — заголовок верхнего уровня
  • MD042 пустые ссылки / MD045 картинки без alt
  • MD047 конечный перевод строки

Правила китайской типографики:

  • CN001: пробел между китайским и латиницей/цифрами.
  • CN002 (строго): полноширинная пунктуация в смешанных контекстах.

Авто-исправление применяет только безопасные детерминированные правки. Наборы правил: По умолчанию, Строгий, Мягкий.

Примеры результатов

1 Примеры

Проверить README со смешанными маркерами и без языка кода

Находит конечные пробелы, несогласованные маркеры, код без языка, скачки заголовков и интервалы CN/EN; авто-исправляет безопасные.

Markdown lint report with auto-fixed output.
Показать параметры ввода
{ "markdown": "# Project\n\nIntro line. \n\n- item one\n* item two\n\n```\nconst x = 1\n```\n\n### Skipped h2\n\n## 使用Python3开发\n", "ruleSet": "default", "autoFix": true }

Ключевые факты

Категория
Текст и письмо
Типы входных данных
textarea, select, checkbox
Тип результата
html
Покрытие примерами
4
API доступен
Yes

Обзор

Этот инструмент позволяет быстро проверить качество и стиль разметки Markdown на соответствие 15 правилам markdownlint и 2 правилам китайской типографики. Он находит ошибки форматирования, такие как пропущенные уровни заголовков, лишние пробелы и отсутствие указания языка в блоках кода, а также автоматически исправляет безопасные дефекты разметки.

Когда использовать

  • •Перед публикацией документации или файлов README в репозиториях для обеспечения единого стиля оформления.
  • •При необходимости быстро исправить мелкие ошибки разметки, такие как лишние пустые строки или концевые пробелы, в автоматическом режиме.
  • •Для проверки текстов со смешанным использованием китайских и латинских символов на соответствие правилам типографики.

Как это работает

  • •Вставьте текст в формате Markdown в текстовое поле ввода.
  • •Выберите подходящий набор правил (По умолчанию, Строгий или Мягкий) и включите или отключите опцию автоматического исправления.
  • •Инструмент разобьет документ на блоки, проанализирует их с помощью встроенного движка правил и сформирует отчет с указанием строк и типов ошибок, применив безопасные правки к тексту.

Сценарии использования

Проверка технической документации на соответствие стандартам оформления перед релизом.
Автоматическое удаление лишних пробелов и пустых строк в статьях, написанных в Markdown.
Форматирование смешанных текстов с китайскими и английскими символами для соблюдения правил типографики.

Примеры

1. Исправление разметки файла README

Технический писатель
Контекст
Разработчики часто коммитят файлы README с хаотичной разметкой: смешивают маркеры списков, забывают указывать язык для блоков кода и оставляют пробелы на концах строк.
Проблема
Необходимо быстро привести файл README.md к единому стандарту оформления без ручного редактирования каждой строки.
Как использовать
Скопируйте содержимое README в поле ввода, выберите набор правил «По умолчанию», активируйте опцию «Авто-исправление безопасных» и запустите проверку.
Пример конфигурации
ruleSet: "default", autoFix: true
Результат
Инструмент автоматически заменил все маркеры списков на дефисы, удалил концевые пробелы и вывел предупреждение о необходимости указать язык программирования для блока кода.

2. Проверка структуры заголовков в документации

Редактор базы знаний
Контекст
При написании длинных статей авторы иногда нарушают иерархию заголовков, например, перескакивают с H1 сразу на H3.
Проблема
Выявить нарушения структуры документа и исправить мелкие недочеты форматирования.
Как использовать
Вставьте текст статьи в поле ввода, выберите «Строгий» набор правил и запустите анализ.
Пример конфигурации
ruleSet: "strict", autoFix: true
Результат
Получен отчет с указанием конкретных строк, где нарушена вложенность заголовков (правило MD001), а лишние пустые строки между разделами были удалены автоматически.

Проверить на примерах

markdown
Примеры Markdown
Примеры формата Markdown от простых до сложных структур документов
title token markdown
markdown
Примеры Markdown Презентаций
Markdown колоды в стиле Remark/Marp для тестирования экспорта в PDF
title token markdown
markdown
Примеры Извлечения Ссылок Markdown
Примеры документов Markdown с различными типами ссылок для тестирования инструмента извлечения ссылок Markdown
title token markdown
markdown
Test Pyramid Examples - Руководство по Тестовой Стратегии
Всесторонние примеры реализации тестовой пирамиды включая модульные тесты, интеграционные тесты, E2E тесты, организацию тестов и стратегические тестовые паттерны для сбалансированного обеспечения качества программного обеспечения
preferred input family markdown
markdown

Связанные хабы

Инструменты экспорта, OCR и конвертации Markdown
Сравните инструменты Markdown в PDF, PDF в Markdown, OCR, экспорта слайдов и структурной конвертации Markdown в одном хабе для публикации документации.
Инструменты для написания и публикации Markdown
Соберите в одном хабе инструменты для форматирования Markdown, проверки ссылок, объединения файлов, предпросмотра, перевода и экспорта для документации и публикации.
Инструменты для написания, извлечения и публикации документации
Пишите документацию, извлекайте материалы из кода или PDF, проверяйте Markdown и экспортируйте аккуратные результаты в одном workflow-хабе.
Инструменты кодирования и конвертации аудио
Сравните инструменты конвертации аудиоформатов, изменения битрейта, частоты дискретизации, смены кодека и экспорта в одном хабе.

FAQ

Какие ошибки исправляются автоматически?

Автоматически исправляются только безопасные дефекты: удаляются концевые пробелы, лишние пустые строки, нормализуются маркеры списков и добавляется финальный перевод строки.

Что делает правило CN001?

Оно проверяет наличие пробела между китайскими и латинскими символами или цифрами для улучшения читаемости текста.

Чем отличаются наборы правил?

Набор «Строгий» включает жесткие ограничения (например, длину строки), «По умолчанию» проверяет базовый стиль и типографику, а «Мягкий» скрывает предупреждения о стиле, оставляя только критические ошибки.

Будет ли изменен исходный текст при обнаружении неверной иерархии заголовков?

Нет, такие структурные проблемы, как пропуск уровней заголовков (MD001), только выводятся в отчете для ручного исправления.

Можно ли использовать инструмент для проверки файлов README перед коммитом?

Да, инструмент идеально подходит для быстрой валидации файлов README.md и другой проектной документации перед отправкой в Git.

Документация API

Конечная точка запроса

POST /ru/api/tools/markdown-lint-style-checker

Параметры запроса

Имя параметра Тип Обязательно Описание
markdown textarea Да -
ruleSet select Нет -
autoFix checkbox Нет -

Формат ответа

{
  "result": "
Processed HTML content
",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
HTML: HTML

Документация MCP

Добавьте этот инструмент к конфигурации сервера MCP: 

{
  "mcpServers": {
    "elysiatools-markdown-lint-style-checker": {
      "name": "markdown-lint-style-checker",
      "description": "Проверяет Markdown по ~15 правилам markdownlint плюс 2 правилам китайской типографики, с отчётом по строкам и авто-исправлением безопасных проблем",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=markdown-lint-style-checker",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Вы можете объединять несколько инструментов, например: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, максимум 20 инструментов.

Если вы столкнулись с проблемами, пожалуйста, свяжитесь с нами по адресу [email protected]