Python Pandas df.to_markdown tablefmt 参数详解

在 Pandas 的 df.to_markdown() 方法中，tablefmt 参数用于指定 Markdown 表格的格式，它依赖于底层库 tabulate 的支持。以下是常用的 tablefmt 参数选项及其效果说明：

1. 常用 tablefmt 参数

2. 推荐参数（Markdown 兼容）

• 最紧凑：tablefmt="plain"

  | A | B |
  |---|---|
  | 1 | x |
  

• GitHub 风格（默认对齐）：tablefmt="github"

  | A   | B   |
  | :-- | :-- |
  | 1   | x   |
  

• 无多余空格：结合 str.replace() 后处理

  markdown = df.to_markdown(tablefmt="github").replace("| :-", "| -")
  

3. 查看所有可用格式

通过 tabulate 库直接获取完整列表：

from tabulate import tabulate
print(tabulate._table_formats)  # 输出所有支持的格式

4. 示例代码

import pandas as pd

df = pd.DataFrame({"A": [1, 2], "B": ["x", "y"]})

# 紧凑格式
print(df.to_markdown(tablefmt="plain", index=False))

# GitHub 风格（默认）
print(df.to_markdown(tablefmt="github", index=False))

# 自定义对齐（后处理）
github_md = df.to_markdown(tablefmt="github", index=False)
compact_md = "\n".join(
    line if not line.startswith("| :") else "| - | - |"
    for line in github_md.split("\n")
)
print(compact_md)

5. 注意事项

• Markdown 兼容性："grid"、"html" 等格式可能不被所有渲染器支持。
• 对齐控制：若需完全移除对齐符号（如 :-:），建议用 "plain" 或后处理字符串。
• 性能：复杂格式（如 "grid"）可能比简单格式（如 "plain"）生成速度稍慢。

根据需求选择合适的 tablefmt 参数即可！