Polars DataFrame如何实现类似Pandas的df.to_markdown()功能？

问题场景 #

在Pandas中，我们可以通过以下代码在Notebook中输出美观的Markdown表格：

from IPython.display import display, Markdown

display(Markdown(my_df.to_markdown()))

但Polars DataFrame并没有to_markdown()方法，执行类似逻辑会抛出错误：

AttributeError: 'DataFrame' object has no attribute 'to_markdown'

当前的临时解决方案是先将Polars DataFrame转为Pandas DataFrame再处理：

to_display = my_df.to_pandas()
display(Markdown(to_display.to_markdown()))

以下是几种无需转Pandas的更优实现方式：

方法1：结合Polars write_csv与tabulate库 #

利用Polars导出CSV字符串的能力，配合tabulate库直接生成Markdown表格，无需依赖Pandas：

from IPython.display import display, Markdown
from tabulate import tabulate
import polars as pl

# 示例Polars DataFrame
my_df = pl.DataFrame({"col1": [1, 2, 3], "col2": ["x", "y", "z"]})

# 导出为CSV字符串，再用tabulate转换为Markdown格式
csv_content = my_df.write_csv()
markdown_table = tabulate(csv_content.splitlines(), headers="firstrow", tablefmt="github")
display(Markdown(markdown_table))

方法2：使用Polars to_string的格式化参数 #

Polars的to_string方法支持通过formatting参数指定表格格式，直接生成类Markdown的表格字符串，在Notebook中展示效果良好：

from IPython.display import display, Markdown
import polars as pl

my_df = pl.DataFrame({"col1": [1, 2, 3], "col2": ["x", "y", "z"]})

# 指定tablefmt为github（Markdown兼容格式）
table_str = my_df.to_string(formatting={"tablefmt": "github"})
display(Markdown(table_str))

方法3：调用Polars内部的_repr_markdown_方法 #

Polars内置了用于Notebook渲染的_repr_markdown_方法，直接调用即可输出标准Markdown表格，是最简洁的方式，但注意这是内部隐藏API，未来版本可能会变动，适合临时展示使用：

from IPython.display import display, Markdown
import polars as pl

my_df = pl.DataFrame({"col1": [1, 2, 3], "col2": ["x", "y", "z"]})

display(Markdown(my_df._repr_markdown_()))

内容的提问来源于stack exchange，提问作者Fontanka16