Как пользоваться
- Введите заголовок в первой строке, а данные под ним или откройте «Заполнить из CSV…» и вставьте ячейки из электронной таблицы.
- Добавляйте и удаляйте строки и столбцы с помощью кнопок.
- Настройте выравнивание каждого столбца через меню над ним.
- Выберите Markdown или HTML и скопируйте или скачайте таблицу.
Как это работает
Вывод в Markdown соответствует синтаксису таблиц GitHub Flavored Markdown (GFM), который поддерживают GitHub, GitLab, многие генераторы документации и большинство редакторов Markdown. Первая строка становится заголовком, за ней идёт разделительная строка, задающая выравнивание: :--- — влево, :---: — по центру, ---: — вправо и --- — по умолчанию.
Содержимое ячеек экранируется, чтобы не сломать таблицу: символ | внутри ячейки записывается как \|, а перенос строки превращается в <br>, поскольку строка таблицы GFM должна оставаться одной строкой. Прочая разметка Markdown в ячейках, например **жирный** или `код`, сохраняется и будет отображаться средством просмотра Markdown. При включённой опции «Выравнивать столбцы пробелами» каждый столбец дополняется до одинаковой ширины, чтобы таблица была читаемой в виде обычного текста; символы китайского, японского или корейского языков считаются шириной в два столбца. Строки с меньшим числом ячеек дополняются пустыми ячейками.
Импорт принимает текст, разделённый табуляцией (то, что электронные таблицы помещают в буфер обмена), CSV с запятыми или точками с запятой, включая поля в кавычках с запятыми, кавычками и переносами строк, а также существующие таблицы Markdown, у которых считывается и строка выравнивания.
Вывод в HTML — это обычный <table> с <thead> и <tbody>. Текст экранируется для HTML (& < > "), переносы строк превращаются в <br>, а выравнивание задаётся встроенными стилями text-align, поэтому работает без таблицы стилей.
Примеры
Из электронной таблицы в README
Выберите диапазон в Google Sheets, скопируйте его, вставьте в поле импорта и нажмите «Заполнить таблицу». Задайте столбцу с ценой выравнивание вправо и скопируйте Markdown в README.md.
Текст с вертикальной чертой
Ячейка, содержащая «Unlimited | fair use», записывается как Unlimited \| fair use, поэтому GitHub показывает вертикальную черту, а не начинает новый столбец.
Наведение порядка в существующей таблице
Вставьте написанную вручную таблицу Markdown с неровными интервалами, нажмите «Заполнить таблицу» и скопируйте результат обратно: все столбцы выровнены, а выравнивание сохранено.
Часто задаваемые вопросы
Может ли ячейка содержать перенос строки?
Нет, не как настоящий перенос строки, потому что каждая строка таблицы в Markdown должна быть одной строкой. Генератор записывает вместо этого <br>, который GitHub и большинство средств просмотра отображают как перенос строки.
Почему обязательно нужна строка заголовка?
Таблицы GFM всегда начинаются со строки заголовка, за которой следует строка выравнивания. Если видимые заголовки не нужны, можно оставить ячейки заголовка пустыми, но большинство просмотрщиков всё равно показывают линию заголовка.
Можно ли объединить ячейки?
Нет. Таблицы Markdown не поддерживают объединение ячеек (colspan или rowspan). Если они нужны, используйте вывод в HTML и добавьте атрибуты colspan или rowspan вручную.
Влияют ли отступы на вид таблицы при отображении?
Нет. Лишние пробелы игнорируются при отображении Markdown. Отступы только делают исходный текст удобнее для чтения и правки.
Конфиденциальность
Таблица создаётся только в вашем браузере. Введённые или вставленные данные не загружаются, не сохраняются и не используются в аналитике.