Как пользоваться: CSV и Excel в Markdown-таблицу
- Скопируйте ячейки из Excel или Google Sheets и вставьте их, откройте файл CSV / XLSX / JSON или загрузите пример.
- Выберите выравнивание колонок: режим Авто выравнивает числовые колонки по правому краю.
- Оставьте Выравнивать колонки включенным, чтобы таблица читалась в виде обычного текста, или выключите его для самого короткого результата.
- Скопируйте Markdown в README, задачу, pull request или документацию.
Что такое Markdown-таблица?
Markdown-таблицы входят в GitHub Flavored Markdown (GFM) и поддерживаются GitHub, GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs и большинством генераторов статических сайтов. Таблица состоит из строки заголовков, строки-разделителя из дефисов и одной строки на каждую запись; ячейки разделяются вертикальными чертами:
| plan | users | price |
| :--- | ----: | ----: |
| free | 120 | 0 |
| pro | 48 | 49 |Синтаксис выравнивания
| Ячейка-разделитель | Выравнивание |
|---|---|
:--- | По левому краю |
:---: | По центру |
---: | По правому краю |
--- | По умолчанию для отображения (обычно по левому краю) |
Режим Авто выравнивает по правому краю колонки, которые содержат только числа, чтобы значения совпадали по последней цифре, а всё остальное выравнивает по левому краю.
Символы, которые ломают таблицы
- Вертикальные черты (
|) внутри ячейки начали бы новую колонку, поэтому их экранируют как\|. - Переносы строк в Markdown завершают строку таблицы. Их заменяют на
<br>(его отображает GitHub) или на пробелы. - Обратные слеши экранируются, чтобы отображаться как есть.
Зачем выравнивать колонки?
Выравнивание добавляет пробелы, чтобы в исходнике все колонки имели одинаковую ширину. Отображение их игнорирует, но исходный файл становится удобнее для чтения в код-ревью и инструментах сравнения. Отключите его для самого компактного результата, например если ячейки содержат длинный текст и строки получаются очень широкими.
Начинаете с JSON? В разделе JSON в Markdown-таблицу есть настройки для вложенных данных. Нужен HTML? Попробуйте генератор HTML-таблиц.
Также ищут как: excel в markdown, csv в markdown, генератор markdown таблиц, google sheets в markdown, конвертер markdown таблиц, markdown таблица онлайн, gfm таблица, таблица markdown github.
Инструменты, которые хорошо сочетаются с CSV и Excel в Markdown-таблицу
- Markdown в HTML — Введите или вставьте Markdown и мгновенно получите чистый HTML: с безопасным живым предпросмотром, таблицами GFM, списками задач и блоками кода с ограждениями.
- Генератор README — Заполните несколько полей и получите аккуратный README.md, готовый для GitHub: бейджи, установка, пример использования, таблица настроек, переменные окружения, план развития и лицензия.
- Excel в JSON — Откройте книгу .xlsx или вставьте ячейки прямо из Excel или Google Sheets и получите чистый JSON.
- JSON в Excel — Превратите JSON-массив в настоящую книгу Excel.
Часто задаваемые вопросы
Как вставить таблицу Excel в GitHub?
Может ли Markdown-таблица быть без заголовка?
Могут ли ячейки содержать переносы строк?
<br>, который GitHub и большинство отображающих систем показывают как новую строку внутри ячейки.