Входных данных пока нет.
Форматтер Markdown с проверкой отображения
Этот инструмент для форматирования Markdown приводит документ к единому стилю — маркеры, заголовки, нумерованные списки, отступы, таблицы и пустые строки — и затем проверяет, что итоговый HTML не изменился. Вставьте Markdown и скачайте аккуратную версию.
Обновлено:
Как это работает
Вставьте Markdown
Вставьте текст, откройте файл .md или нажмите «Открыть по ссылке». Пример — нарочно неаккуратный список изменений (changelog).
Выберите стиль
Задайте символ маркера, нумерацию, маркеры выделения, ограждение кода и вид принудительных переносов. В каждом параметре можно выбрать «Как есть».
Проверьте и скачайте
Сравните отформатированный текст, посмотрите на вкладке «Изменения», что поменялось, и результат проверки отображения, затем скопируйте или скачайте файл.
Возможности
Доказательство, что ничего не потерялось
Исходный текст и результат отрисовываются парсером CommonMark, и полученный HTML сравнивается. Зеленая галочка означает, что изменилось только оформление исходника.
Правильные списки
Один символ маркера, перенумерованные списки и вложенные пункты с отступом под текстом родителя. Список, который начинается с другого маркера, остается отдельным списком.
Выровненные таблицы
Вертикальные черты стоят ровно, ячейки дополняются пробелами, а строка выравнивания сохраняет :--, :-: и --: как были.
Заголовки и линии
Подчеркнутые заголовки становятся заголовками с #, закрывающие решетки и лишние пробелы удаляются, а линии *** и ___ превращаются в ---.
Код не трогается
Блоки кода с ограждением и с отступом, HTML-блоки и front matter копируются без изменений.
Всегда один и тот же результат
Форматирование детерминированное и идемпотентное: повторный запуск на результате ничего не меняет.
Ограничения и конфиденциальность
Документы до 5 MB. Форматирование и проверка отображения выполняются в браузере (большие тексты — в фоновом потоке); текст не загружается на сервер и не сохраняется. Подробнее — на странице о конфиденциальности.
Частые вопросы
Как отформатировать Markdown-файл?
Вставьте текст или перетащите файл .md, оставьте стиль по умолчанию и скачайте результат. Вкладка «Изменения» показывает, сколько всего переписано.
Изменится ли вид моего README?
Нет. Проверка отображения сравнивает HTML до и после. Меняются только пробелы, маркеры и выравнивание в исходном тексте.
Почему строка #Заголовок не становится заголовком?
Без пробела после # и CommonMark, и GitHub показывают такую строку как текст. Если превратить ее в заголовок, изменится сам документ, поэтому строка остается как есть.
Что использовать для списков — * или -?
Оба варианта отображаются одинаково. Дефис чаще выбирают в руководствах по стилю и линтерах; главное — выбрать один и придерживаться его.
Что делает параметр «Упорядочить пустые строки»?
Сводит несколько пустых строк подряд к одной и добавляет пустую строку вокруг заголовков, блоков кода и таблиц — некоторым парсерам это нужно.
Чем это отличается от Prettier или markdownlint?
Инструмент применяет основные правила форматирования этих утилит без установки и вдобавок наглядно проверяет отображение. Формулировки и ссылки он не проверяет.