Форматировщик Markdown
Приведите Markdown в порядок с помощью этого форматировщика Markdown. Вставьте README, страницу документации или заметки: инструмент удалит пустые строки в начале и конце и выровняет все таблицы с вертикальными чертами. Ширина ячеек будет дополнена до самой широкой записи в столбце, а строка-разделитель будет перестроена с соответствующим количеством тире, при этом двоеточия выравнивания сохранятся. Все остальное останется без изменений, чтобы авторы и разработчики получили аккуратные таблицы без неожиданностей.
Часто задаваемые вопросы
Что меняет форматировщик Markdown?
Он выравнивает таблицы с вертикальными чертами и удаляет пустые строки и пробелы в начале и конце документа. Заголовки, абзацы, списки, ссылки и выделение остаются в точности такими, как вы их написали.
Как форматируются таблицы?
В начале и конце каждой строки добавляется вертикальная черта, а ширина каждой ячейки дополняется пробелами до ширины самой широкой ячейки в столбце; ширина столбца составляет не менее трех символов. Строка-разделитель перестраивается с тире той же ширины.
Сохраняется ли выравнивание столбцов?
Да, двоеточия в строке-разделителе сохраняются. Выравнивание по левому краю, по центру и по правому краю, заданное как :---, :---: и ---:, остается после форматирования.
Меняются ли таблицы внутри блоков кода?
Нет, все содержимое между ограждениями из трех обратных кавычек или трех тильд остается без изменений. Это относится и к тексту в блоках кода, который выглядит как таблица.
Почему столбцы с буквами с диакритическими знаками или эмодзи выглядят неровно?
Ширина ячеек измеряется в байтах UTF-8, поэтому символы за пределами ASCII занимают от двух до четырех байт. В текстовом редакторе в столбцах с такими символами могут появиться лишние пробелы, но на отображение таблицы это не влияет.
Меняются ли маркеры списков или стили заголовков?
Нет, маркеры списков, нумерация, маркеры заголовков и пробелы внутри абзацев сохраняются в исходном виде. Форматировщик намеренно работает осторожно, чтобы не менять отображение документа.
Изменится ли отображение отформатированного документа?
Нет, добавление пробелов в ячейки таблицы и удаление пустых строк по краям документа не меняют результат отображения. GitHub, GitLab и другие средства отображения показывают одинаковые таблицы до и после форматирования.
Можно ли использовать его для файлов MDX?
Да, но форматировщик MDX подходит лучше, потому что он помечает результат как mdx. Оба инструмента применяют одинаковые правила и оставляют импорты и JSX без изменений.
Почему результат заключен в блок кода markdown?
Результат возвращается внутри блока кода с пометкой markdown, поэтому при вставке в просмотрщик Markdown он отображается как исходный текст. Скопируйте строки между внешними ограждениями в файл .md.
Каков максимальный размер документа?
До 5 MB за один запуск; более крупный ввод отклоняется с сообщением. Результат идентичен варианту Markdown форматировщика кода.