Markdown таблица

Что это и зачем

Markdown — лёгкий язык разметки. Создан Джоном Грубером в 2004 году с целью «писать в plain text, чтобы было читаемо как в исходнике, так и в отрендеренном виде». Сейчас — стандарт de facto для технической документации: GitHub README, документация npm-пакетов, статьи на VC.ru, Habr.com, dev.to, заметки в Notion / Obsidian / Logseq.

Главная проблема Markdown-таблиц — их неудобно писать вручную. Каждая колонка должна быть выровнена пробелами для читаемости в исходнике; разделители выравнивания (---, :---, :---:, ---:) легко перепутать. Этот инструмент решает: визуально редактируете → копируете готовый MD/HTML/CSV.

Синтаксис MD-таблиц

| Колонка 1 | Колонка 2 | Колонка 3 |
| :-------- | :-------: | --------: |
| лево      |  центр    |    право  |
| данные    |  данные   |    данные |

• Заголовки в первой строке между |.
• Разделитель во второй строке. --- = просто разделитель.
• Выравнивание: :--- = лево (по умолчанию), :---: = центр, ---: = право.
• Минимум 3 дефиса в каждой ячейке разделителя (требование GFM).
• Пробелы вокруг | необязательны, но рекомендуются для читаемости.
• Параметры по строке могут отличаться по ширине — рендерер подгонит.

A pipe character | followed by a hyphen --- and another pipe | indicates a column separator. The colons : in the separator row indicate text alignment for the column.— GitHub Flavored Markdown Spec, 2021

Советы по таблицам

• Используйте Markdown для простых данных. 3-7 колонок, 5-30 строк — идеально. Больше — становится нечитаемым в исходнике.
• HTML для сложных. Если нужны merged cells (rowspan, colspan), переносы внутри ячейки, разные стили — экспортируйте в HTML.
• CSV для импорта в Excel. Один клик в Excel → таблица готова. Или загрузите в Google Sheets.
• Не злоупотребляйте. Если в ячейке абзац текста, ссылка, картинка — это уже не таблица, это лейаут. Используйте обычные параграфы или callout-блоки.
• Числовые данные — выравнивание справа. Облегчает сравнение значений по разрядам.
• Заголовки — bold по умолчанию. Не нужно дополнительно делать **заголовок** в ячейке заголовка.
• Inline-код. `var name = 'value'` внутри ячейки работает отлично.
• Эмодзи. ✓ ✗ ⚠ работают везде. Полезно для статус-таблиц.

Альтернативные форматы

• RST (reStructuredText). Используется в Sphinx (Python documentation). Таблицы могут быть с merged cells. Сложнее в исходнике.
• AsciiDoc. Для книг и серьёзной документации. Поддерживает full-page таблицы с группировкой.
• LaTeX. Для научных публикаций. Самый мощный, но крутейшая кривая обучения.
• Org-mode (Emacs). Возможно лучшие таблицы в текстовом виде — с автовычислениями (как Excel).
• JSON / YAML. Для структурированных данных, не для отображения. Конвертируйте в MD при необходимости.