Метод to_markdown
Метод to_markdown применяется к DataFrame
и преобразует таблицу в строку с таблицей в формате Markdown.
Этот метод полезен для вставки таблиц в документацию, Markdown-файлы
или Jupyter-ноутбуки. Первым параметром можно передать путь к файлу,
куда будет сохранён результат. Если параметр не указан, метод возвращает
строку с Markdown-разметкой.
Синтаксис
df.to_markdown([buf], [mode], [index], [tablefmt], [colalign])
Основные параметры
Метод принимает следующие ключевые параметры:
buf - путь к файлу для сохранения (опционально)
mode - режим открытия файла, по умолчанию 'wt'
index - включать ли индекс в таблицу, по умолчанию True
tablefmt - формат таблицы, по умолчанию 'pipe'
colalign - выравнивание столбцов (строка или список)
Пример
Давайте преобразуем таблицу в Markdown-строку:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3],
'b': [10, 20, 30]
})
res = df.to_markdown()
print(res)
Результат выполнения кода:
"| | a | b |
|---:|----:|----:|
| 0 | 1 | 10 |
| 1 | 2 | 20 |
| 2 | 3 | 30 |"
Пример
Теперь преобразуем таблицу без индекса:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3],
'b': [10, 20, 30]
})
res = df.to_markdown(index=False)
print(res)
Результат выполнения кода:
"| a | b |
|----:|----:|
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |"
Пример
Изменим формат таблицы на 'grid':
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3],
'b': [10, 20, 30]
})
res = df.to_markdown(tablefmt='grid')
print(res)
Результат выполнения кода:
"+----+------+------+
| | a | b |
+====+======+======+
| 0 | 1 | 10 |
+----+------+------+
| 1 | 2 | 20 |
+----+------+------+
| 2 | 3 | 30 |
+----+------+------+"
Пример
Установим выравнивание для столбцов:
import pandas as pd
df = pd.DataFrame({
'a': [1, 2, 3],
'b': [10, 20, 30]
})
res = df.to_markdown(colalign=('left', 'right'))
print(res)
Результат выполнения кода:
"| | a | b |
|:---|:----|----:|
| 0 | 1 | 10 |
| 1 | 2 | 20 |
| 2 | 3 | 30 |"
