Генератор таблиц Markdown
Редактируйте таблицу в сетке или вставьте её из электронной таблицы, CSV или TSV и скопируйте как таблицу Markdown для GitHub с ровными столбцами.
Работает в браузере; введённые вами данные не покидают устройство
Таблицы до нескольких тысяч ячеек. В ячейке таблицы Markdown помещается только одна строка текста, поэтому переносы строк внутри ячейки записываются как <br>, а вертикальные черты экранируются. Первая строка всегда заголовок, как того требует GitHub.
Как сделать таблицу Markdown
- Вводите данные в сетку или вставляйте прямо в неё ячейки, скопированные из электронной таблицы. Можно также вставить в поле CSV, TSV или готовую таблицу Markdown и заполнить сетку из неё.
- Добавляйте и удаляйте строки и столбцы и выберите для каждого столбца выравнивание по левому краю, по центру или по правому краю.
- Скопируйте Markdown и вставьте его в README, issue, pull request или документ.
Как записывается таблица Markdown
Таблица Markdown в стиле GitHub это обычный текст: строка заголовка, строка из дефисов, задающая выравнивание, и по одной строке на каждую строку данных, а ячейки разделены вертикальными чертами. Этот формат GitHub отображает в README, issue и pull request, и его понимают многие другие инструменты, в том числе сайты документации и приложения для заметок.
Сетка хранит ячейки; первая строка это заголовок. У каждого столбца есть выравнивание. По левому краю записывается :---, по центру :---:, по правому краю ---:, а без выравнивания остаются простые дефисы. Текст ячеек при необходимости экранируется: вертикальная черта превращается в \|, а перенос строки в HTML-тег <br>. Затем инструмент выравнивает столбцы пробелами, чтобы исходный текст выглядел как таблица. Он учитывает ширину каждого символа, а не число байтов, поэтому буквы с диакритикой тоже выстраиваются ровно.
Вставка из электронной таблицы самый быстрый способ начать. Электронные таблицы помещают скопированные ячейки в буфер обмена как текст с табуляциями, по одной строке на каждую строку таблицы, и сетка читает его напрямую. Файлы CSV и TSV работают так же через поле вставки, а поля в кавычках и переносы строк внутри кавычек обрабатываются. Если вставить готовую таблицу Markdown, ячейки и выравнивание считываются обратно в сетку, и их можно менять.
Советы
- Есть JSON вместо электронной таблицы? Сначала преобразуйте его через JSON в CSV, а результат вставьте сюда.
- Посмотрите, как будет выглядеть таблица, с помощью Markdown в HTML.
- Чтобы пойти в обратную сторону, от веб-страницы к Markdown, используйте HTML в Markdown.
Вопросы и ответы
Как превратить электронную таблицу в таблицу Markdown?
Выделите ячейки в Excel, Google Таблицах или Numbers, скопируйте и вставьте в любую ячейку сетки. Ячейки из электронной таблицы приходят как текст с разделителями-табуляциями, и сетка заполняется начиная с ячейки, в которую вы вставили данные. Можно также вставить CSV или TSV в поле над сеткой и нажать Заполнить сетку из этого текста.
Как работает выравнивание столбцов?
Строка из дефисов под заголовком задаёт выравнивание: :--- означает по левому краю, :---: по центру, ---: по правому краю, а --- выравнивание по умолчанию. Выберите выравнивание для каждого столбца над его ячейкой заголовка.
Что происходит с вертикальной чертой или переносом строки в ячейке?
Вертикальная черта | закончила бы ячейку, поэтому она записывается как \|. Таблицы Markdown не могут содержать настоящие переносы строк, поэтому перенос в ячейке записывается как <br>, и GitHub показывает его как новую строку.
Почему столбцы дополняются пробелами?
Пробелы выравнивают столбцы, чтобы таблицу было удобно читать как обычный текст. На отображение это не влияет. Снимите флажок Выровнять столбцы, чтобы получить самую короткую запись.
Можно ли редактировать готовую таблицу Markdown?
Да. Вставьте её в поле и нажмите Заполнить сетку из этого текста. Инструмент прочитает ячейки и выравнивание и поместит их в сетку.
Загружается ли моя таблица на сервер?
Нет. Таблица создаётся в вашем браузере, и ничто не покидает ваше устройство.