Перейти до вмісту

Лінтер Markdown

Знайдіть розірвані посилання, пропущені рівні заголовків і невизначені блоки коду в Markdown.

Введення
Існуючі шляхи файлів (по одному в рядку, опціонально)
Вихід

Лінтер Markdown

Вставте документ Markdown, і цей інструмент скаже, що в ньому не так, один результат в рядку з приєднаним номером рядка. Він завжди перевіряє невідповідність **жирного**, __жирного__, ~~закресленого~~ та `коду` маркерів, незбалансовані дужки [ ] посилань і порожні цілі посилань або зображень, рівні заголовків, які пропускають рівень (H1, за яким одразу йде H3), і блоки коду з огорожею, які відкриті, але ніколи не закриті — тип синтаксису, який добре відображається в одному процесорі Markdown і ламається в іншому.

Опції додають перевірки, які більше стосуються консистентності, ніж синтаксису. Увімкніть перевірку визначень посилань, щоб виявити посилання [text][ref] без відповідного визначення [ref]: url нижче, та визначення, які визначені, але ніколи не використовуються. Перевірка повторюваних заголовків помічає повторюваний текст заголовка та більше одного заголовка верхнього рівня, що збиває з пантелику як читачів, так і генератори вмісту. Перевірка консистентності списків виявляє маркований список, який переходить з - на * посередині, або пронумеровані елементи, які випадають з послідовності. Ви також можете вимагати мову в кожному блоці коду з огорожею, помічати пробіли в кінці рядків (рівно два пробіли залишаються нетронутими, оскільки це навмисний розрив рядка Markdown), та обмежувати довжину рядка. Вставте список існуючих шляхів файлів у друге поле, і локальні цілі посилань і зображень будуть перевірені проти нього, щоб перейменований або видалений файл был видно як розірване посилання перед публікацією.

Лінтер обробляє закінчення рядків Windows (CRLF) і Unix (LF) однаково, і перевірки, які можуть дати збій на вмісті коду — маркери, посилання, заголовки, списки, пробіли в кінці — пропускаються для тексту всередині блоку коду з огорожею. Перевірка довжини рядка все ще застосовується скрізь. Панель виводу виділяє кожен рядок результату червоним кольором, щоб довгий звіт було легко переглянути, а підрахунок вище показує відскановані рядки, знайдені проблеми та підраховані заголовки.

Все працює локально у вашому браузері. Документ, який ви вставляєте, і будь-які шляхи файлів, які ви додаєте для перевірки посилань, ніколи не завантажуються ніде. Коли закінчите, скопіюйте звіт, завантажте його як файл .txt або відправте на вхід іншого інструменту для подальшої роботи.

FAQ

Він повністю аналізує Markdown, як би це зробив рендерер?
Ні. Це лінійний евристичний перевірювач, розроблений для виявлення поширених помилок — невідповідні маркери, розірвані посилання, пропущені рівні заголовків, невизначені огорожі коду — а не повний парсер CommonMark, тому незвичайна конструкція може іноді бути пропущена або переоцінена.
Чому запуск з двох пробілів в кінці не помічається?
Два пробіли в кінці — це стандартний синтаксис Markdown для жорсткого розриву рядка, тому вони залишаються нетронутими. Один пробіл в кінці або табуляція в кінці помічаються, оскільки це майже завжди випадково.
Що вважається повторюваним заголовком?
Текст заголовка порівнюється без урахування регістру після обрізання, тому "Setup" та "setup" розглядаються як один заголовок.
Як перевірити посилання проти реальних файлів у моєму проекті?
Вставте один відносний шлях в рядок у друге поле — ті ж самі шляхи, на які вказують ваші посилання, наприклад docs/setup.md. Локальні цілі посилань і зображень, яких немає в цьому списку, помічаються; зовнішні URL і #якорі завжди пропускаються.
Мій документ завантажується кудись?
Ні. Перевірка запускається повністю у вашому браузері — ваш Markdown та будь-які шляхи файлів, які ви вводите, залишаються на вашому пристрої.