Таблицы Markdown позволяют отображать структурированные данные в читаемом формате, который отображается как таблица HTML. Это руководство охватывает полный GFM (GitHub Ароматизированный Markdown) синтаксис таблицы, варианты выравнивания, расширенные шаблоны и как конвертировать таблицы Word в Markdown.
Основной синтаксис таблицы
Таблица Markdown состоит из трех частей:
- Строка заголовка названия столбцов
- Строка разделителя панели с трубами, определяет таблицу
- Строки данных содержание
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |Описание:
| Колонка 1 | Колонка 2 | Колонка 3 |
|---|---|---|
| Строка 1, колонка 1 | Строка 1, колонка 2 | Строка 1, колонка 3 |
| Строка 2, колонка 1 | Строка 2, колонка 2 | Строка 2, колонка 3 |
Выстраивание столбцов
Используйте колонки в разделительной строке для управления выравниванием:
| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text || Левый выровнен | Центр выровнен. | Прямая линия . |
|---|---|---|
| text | text | text |
| более длинный текст | более длинный текст | более длинный текст |
:---Левое выравнивание (по умолчанию):---:Выстраивать центр---:Правый наклон
Форматирование внутри ячеек таблицы
Большинство форматировок Markdown работает внутри ячеек таблицы:
| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |Что не работает: многострочный контент, вложенные списки, элементы на уровне блоков.
Знаки трубки в ячейках
Если тебе нужна буквальная труба | Внутри клетки, сбежать от нее с обратным шлейфом:
| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |Таблицы без интервалов
Расстояние между трубами необязательно. Это верно:
|Column 1|Column 2|
|---|---|
|Cell|Cell|Но последовательное расстояние делает таблицы более читаемыми. Большинство редакторов и линтеров предпочитают формат с интервалом.
Пустые ячейки
Оставьте пространство между трубами пустым для пустой ячейки:
| A | B | C |
|---|---|---|
| content | | content |
| | content | |Преобразование _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
Word таблицы конвертируются автоматически при использовании WordToMD. The converter handles:
- Стандартные решетки → GFM трубопроводные столы
- Ширина столбцов → стандартизированная (Markdown не контролирует ширину столбцов)
- Форматирование текста внутри ячеек → сохранено (толстый, курсивный, ссылки)
Что не конвертирует:
- Объединенные ячейки (колспан/колспан строк) свалились на ближайшую ячейку
- Содержание нескольких строк ячейки перерывы строк сняты
- Столы с гнездом внутренний стол с плоским покрытием
Комплексные таблицы Word
Объединенные ячейки
Объединенные ячейки Word не имеют эквивалента Markdown. Варианты:
- Реструктуризация Разделить объединенные строки на отдельные таблицы
- Использовать HTML Большинство Markdown процессоров принимают HTML синтаксис таблицы:
<table>
<tr>
<th colspan="2">Merged Header</th>
</tr>
<tr>
<td>Cell 1</td>
<td>Cell 2</td>
</tr>
</table>Содержание нескольких строк ячейки
Использование <br> для перерывов линии внутри ячеек (работает на GitHub и большинстве платформ):
| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |Большие столы
Для таблиц с большим количеством столбцов, рассмотрите, является ли таблица в правильном формате. Альтернативы:
- Список определений (термин + описание)
- Многочисленные более мелкие таблицы по категориям
- Блок кода для структурированных данных (JSON, YAML)
Представление таблиц по платформам
| Платформа | GFM Таблицы | Выравнивание | HTML Таблицы |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ |
| GitLab (ГитЛаб) | ✅ | ✅ | ✅ |
| Notion | ✅ | ❌ | ❌ |
| Obsidian | ✅ | ✅ | ✅ |
| GitBook | ✅ | ✅ | ✅ |
| VS Код предварительного просмотра | ✅ | ✅ | ✅ |
| Confluence (Markdown макро) | ✅ | ✅ | ✅ |
| Джекилл/Хьюго/Астро | ✅ | ✅ | ✅ |
Доступность
Для улучшения доступности убедитесь, что в таблицах есть строка заголовка с значимыми названиями столбцов. Читатели экрана используют строку заголовка для объявления контекста ячейки.
| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |Избегайте использования таблиц для целей планировки используйте их только для фактических табличных данных.
FAQ
Почему моя таблица не отображается в виде простого текста?
Разделительная строка ( |---|---| строка) является обязательным. Без него, анализатор не будет распознавать структуру таблицы.
Можно мне стол без заголовка?
Не в стандартном GFM. Необходимы строка заголовка и разделитель. Если вы не хотите видимого заголовка, используйте пустой заголовок: | | | с разделительным рядом.
Почему мои таблицы из Word выглядят правильно в WordToMD, но неправильно после того, как я вставлю их в другое место? Проблема обычно заключается в оставлении белого пространства в ячейках или несовместимых символах трубки. Большинство Markdown-рендеров мягки, но копирование-клеивание может вводить невидимые символы.
Как я могу создать таблицу программированно из данных?
Библиотеки, как markdown-table (npm) или Pythons tabulate может генерировать таблицы Markdown из массивов. Это полезно для конвертации CSV или данных баз данных.
Соответствующие руководства
- Что такое Markdown? Markdown основы
- Markdown Синтаксис краткая памятка Полная синтаксисная ссылка
- Как преобразовать Word в Markdown Полное руководство по преобразованию
- DOCX к Markdown с таблицами Сосредоточен на преобразовании таблиц
Заключение
Markdown таблицы являются мощными для отображения структурированных данных и широко поддерживаются на всех основных платформах. Для таблиц, которые начинаются с Word, WordToMD преобразует их автоматически в GFM синтаксис. Для сложных макетов резервный вариант HTML и приведенные выше трюки дают вам необходимый контроль.