Таблицы Markdown

Таблицы и блочные цитаты — важные инструменты организации содержимого в Markdown.

Таблицы могут наглядно отображать структурированные данные, а блочные цитаты используются для выделения важной информации или цитирования чужого мнения.

Markdown использует|для разделения разных ячеек и использует-для отделения заголовка от остальных строк.

Формат синтаксиса следующий:

| Header | Header |
| ---- | ---- |
| Cell | Cell |
| Cell | Cell |

Приведённый выше код выводит следующий результат:

Ключевые моменты синтаксиса:

  • Между заголовком и строками данных должна быть разделительная строка
  • Разделительная строка должна содержать как минимум три дефиса---
  • Вертикальные черты на обоих концах|необязательны, но их рекомендуется сохранять для лучшей читаемости
  • Строгое выравнивание не обязательно, но при выравнивании выглядит лучше

Выравнивание

Мы можем задать выравнивание таблицы:

  • ---:Установите выравнивание содержимого и строки заголовка по правому краю.
  • :---Установите выравнивание содержимого и строки заголовка по левому краю.
  • :---:Установите выравнивание содержимого и строки заголовка по центру.

Примеры приведены ниже:

| Left align | Right align | Center align |
| :-----| ----: | :----: |
| Cell | Cell | Cell |
| Cell | Cell | Cell |

Приведённый выше код выводит следующий результат:

Советы по работе со сложными таблицами

Форматирование содержимого ячеек

Внутри ячеек таблицы можно использовать большинство синтаксиса Markdown:

| 功能 | 描述 | 状态 |
|------|------|:----:|
| **用户登录** | 支持邮箱和手机号登录 | ✅ |
| *密码重置* | 通过邮箱重置密码 | ⚠️ |
| `API接口` | RESTful API 设计 | ✅ |
| [文档链接](https://example.com) | 查看详细文档 | 📖 |

Работа с длинным текстом

Если содержимое ячейки длинное, можно использовать следующие приёмы:

Обработка переносов строк:

| 项目 | 详细说明 |
|------|----------|
| 需求分析 | 1. 收集用户需求<br>2. 分析业务场景<br>3. 确定功能范围 |
| 技术选型 | 前端:React + TypeScript<br>后端:Node.js + Express<br>数据库:MongoDB |

Сокращения и ссылки:

| 技术栈 | 说明 | 官网 |
|--------|------|------|
| React | 用户界面库 | [链接](https://reactjs.org) |
| Vue.js | 渐进式框架 | [链接](https://vuejs.org) |
| Angular | 完整的框架 | [链接](https://angular.io) |

Специальные символы в таблицах

Некоторые символы имеют особое значение в таблицах и требуют экранирования:

| 字符 | 转义方法 | 示例 |
|------|----------|------|
| 竖线 | `\|` | 显示 \| 符号 |
| 反斜杠 | `\\` | 显示 \\ 符号 |
| HTML | 直接使用 | <code>&lt;div&gt;</code> |

Рекомендации по улучшению оформления таблиц

Использование эмодзи и символов

| 状态 | 图标 | 说明 |
|:----:|:----:|------|
| 完成 | &#x2705; | 任务已完成 |
| 进行中 | &#x1f504; | 正在处理 |
| 待处理 | &#x23f3; | 等待开始 |
| 错误 | &#x274c; | 出现问题 |
| 警告 | &#x26a0;&#xfe0f; | 需要注意 |

Лучшие практики для таблиц данных

Таблица финансовых данных:

| 月份 | 收入 | 支出 | 利润 | 增长率 |
|:----:|-----:|-----:|-----:|-------:|
| 1月 | ¥50,000 | ¥35,000 | ¥15,000 | - |
| 2月 | ¥55,000 | ¥38,000 | ¥17,000 | +13.3% |
| 3月 | ¥62,000 | ¥42,000 | ¥20,000 | +17.6% |
| **总计** | **¥167,000** | **¥115,000** | **¥52,000** | **+31.1%** |

Таблица сравнения технологий:

| 特性 | React | Vue.js | Angular | 评分 |
|------|:-----:|:------:|:-------:|:----:|
| 学习曲线 | 中等 | 简单 | 复杂 | Vue &#x2b50;&#x2b50;&#x2b50; |
| 性能表现 | 优秀 | 优秀 | 良好 | 平分 &#x2b50;&#x2b50;&#x2b50; |
| 生态系统 | 丰富 | 成长中 | 完整 | React &#x2b50;&#x2b50;&#x2b50; |
| 企业支持 | Facebook | 社区 | Google | Angular &#x2b50;&#x2b50;&#x2b50; |

Обработка адаптивных таблиц

Для сложных таблиц рассмотрите возможность разбиения их на несколько простых таблиц.

Дизайн, удобный для мобильных устройств:

### 基本信息
| 项目 | 值 |
|------|-----|
| 姓名 | 张三 |
| 年龄 | 25 |
| 职业 | 工程师 |

### 联系方式
| 类型 | 信息 |
|------|------|
| 邮箱 | zhang@example.com |
| 电话 | 138-0013-8000 |
| 地址 | 北京市朝阳区 |

Другие расширения