Синтаксис таблиц
Таблицы являются важной частью расширенного синтаксиса Markdown и используются для отображения данных в структурированном виде.
Базовый синтаксис таблиц
Простая таблица
Используйте символ | для разделения столбцов и - для создания строки заголовка:
markdown
| Имя | Возраст | Профессия |
|-------|--------|------------|
| Чжан | 25 | Инженер |
| Ли | 30 | Дизайнер |
| Ван | 28 | Менеджер по продукту |Результат:
| Имя | Возраст | Профессия |
|---|---|---|
| Чжан | 25 | Инженер |
| Ли | 30 | Дизайнер |
| Ван | 28 | Менеджер по продукту |
Выравнивание таблиц
Используйте двоеточия : для управления выравниванием столбцов:
markdown
| Выравнивание слева | Выравнивание по центру | Выравнивание справа |
|:------------------|:---------------------:|-------------------:|
| Контент 1 | Контент 1 | Контент 1 |
| Контент 2 | Контент 2 | Контент 2 |
| Контент 3 | Контент 3 | Контент 3 |Результат:
| Выравнивание слева | Выравнивание по центру | Выравнивание справа |
|---|---|---|
| Контент 1 | Контент 1 | Контент 1 |
| Контент 2 | Контент 2 | Контент 2 |
| Контент 3 | Контент 3 | Контент 3 |
Детали выравнивания
Синтаксис выравнивания
| Синтаксис | Выравнивание | Пример |
|---|---|---|
--- | Слева (по умолчанию) | ` |
:--: | По центру | ` |
--: | Справа | ` |
Таблицы с числовыми данными
Выравнивание справа подходит для отображения чисел:
markdown
| Продукт | Цена | Продажи | Выручка |
|:--------|------:|------:|--------:|
| A | ¥99 | 1 250 | ¥123 750|
| B | ¥199 | 856 | ¥170 344|
| C | ¥299 | 432 | ¥129 168|
| **Итого** | | **2 538** | **¥423 262** |Результат:
| Продукт | Цена | Продажи | Выручка |
|---|---|---|---|
| A | ¥99 | 1 250 | ¥123 750 |
| B | ¥199 | 856 | ¥170 344 |
| C | ¥299 | 432 | ¥129 168 |
| Итого | 2 538 | ¥423 262 |
Форматирование в таблицах
Встроенное форматирование
Ячейки таблиц поддерживают встроенное форматирование Markdown:
markdown
| Функция | Статус | Описание |
|-------------|-------------|-------------------------|
| **Вход** | ✅ Готово | Пользователи могут входить по электронной почте |
| *Регистрация* | 🚧 В процессе | Поддержка регистрации через третьи стороны |
| `Сброс пароля` | ❌ Не сделано | Сброс пароля через электронную почту |
| [Личный кабинет](/) | ⏳ Запланировано | Управление информацией пользователя |Результат:
| Функция | Статус | Описание |
|---|---|---|
| Вход | ✅ Готово | Пользователи могут входить по электронной почте |
| Регистрация | 🚧 В процессе | Поддержка регистрации через третьи стороны |
Сброс пароля | ❌ Не сделано | Сброс пароля через электронную почту |
| Личный кабинет | ⏳ Запланировано | Управление информацией пользователя |
Код в таблицах
markdown
| Команда | Функция | Пример |
|---------|--------------|-------------------|
| `ls` | Список файлов| `ls -la` |
| `cd` | Смена директории | `cd /home/user` |
| `mkdir` | Создание директории | `mkdir new-folder`|
| `rm` | Удаление файлов | `rm -rf folder/` |Результат:
| Команда | Функция | Пример |
|---|---|---|
ls | Список файлов | ls -la |
cd | Смена директории | cd /home/user |
mkdir | Создание директории | mkdir new-folder |
rm | Удаление файлов | rm -rf folder/ |
Сложные примеры таблиц
Сравнение технологий
markdown
| Функция | React | Vue | Angular |
|:---------------|:-----:|:---:|:-------:|
| **Сложность изучения** | Средняя | Легкая | Сложная |
| **Производительность** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| **Экосистема** | Богатая | Хорошая | Полная |
| **Корпоративная поддержка** | Facebook | Независимая | Google |
| **TypeScript** | ✅ | ✅ | ✅ Встроенный |
| **Активность сообщества** | Очень высокая | Высокая | Средняя |Результат:
| Функция | React | Vue | Angular |
|---|---|---|---|
| Сложность изучения | Средняя | Легкая | Сложная |
| Производительность | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| Экосистема | Богатая | Хорошая | Полная |
| Корпоративная поддержка | Независимая | ||
| TypeScript | ✅ | ✅ | ✅ Встроенный |
| Активность сообщества | Очень высокая | Высокая | Средняя |
Документация API
markdown
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|-----------|----------|:------------:|--------------|--------------------------|
| `id` | `number` | ✅ | - | Уникальный идентификатор пользователя |
| `name` | `string` | ✅ | - | Имя пользователя |
| `email` | `string` | ✅ | - | Адрес электронной почты |
| `age` | `number` | ❌ | `null` | Возраст пользователя |
| `avatar` | `string` | ❌ | `"/default.jpg"` | URL аватара |
| `status` | `enum` | ❌ | `"active"` | Статус аккаунта: `active` \| `inactive` |Результат:
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
id | number | ✅ | - | Уникальный идентификатор пользователя |
name | string | ✅ | - | Имя пользователя |
email | string | ✅ | - | Адрес электронной почты |
age | number | ❌ | null | Возраст пользователя |
avatar | string | ❌ | "/default.jpg" | URL аватара |
status | enum | ❌ | "active" | Статус аккаунта: active | inactive |
Советы по форматированию таблиц
Использование эмодзи
markdown
| ОС | Поддержка | Примечание |
|---------|:-------:|---------------|
| Windows | ✅ | Полная поддержка |
| macOS | ✅ | Полная поддержка |
| Linux | ⚠️ | Частичная поддержка |
| iOS | ❌ | Не поддерживается |
| Android | 🚧 | В разработке |Результат:
| ОС | Поддержка | Примечание |
|---|---|---|
| Windows | ✅ | Полная поддержка |
| macOS | ✅ | Полная поддержка |
| Linux | ⚠️ | Частичная поддержка |
| iOS | ❌ | Не поддерживается |
| Android | 🚧 | В разработке |
Распространенные ошибки и решения
1. Несогласованные разделители
markdown
❌ Неправильно:
| Имя | Возраст|Профессия|
|------|----|----------|
|Чжан|25|Инженер|
✅ Правильно:
| Имя | Возраст | Профессия |
|------|-----|------------|
| Чжан | 25 | Инженер |2. Отсутствие строки разделителя
markdown