Python实现Markdown与Excel表格互转的完整方案

1. 为什么需要Markdown与Excel互转？

在日常工作中，我们经常遇到这样的场景：产品经理用Markdown写了需求文档，但开发人员需要将其中的表格数据导入Excel进行分析；或者数据分析师在Excel中整理好了数据，需要以更友好的格式嵌入技术文档。这时候，两种格式间的转换就变得尤为重要。

Markdown作为轻量级标记语言，在技术文档编写中占据主导地位。它的表格语法虽然简单，但功能有限：

code复制| 姓名 | 年龄 | 城市 |
|------|-----|------|
| 张三 | 28  | 北京 |
| 李四 | 32  | 上海 |

而Excel则是数据处理的事实标准，支持公式计算、数据透视等高级功能。两者间的转换难点在于：

• Markdown表格缺乏单元格合并、样式等Excel特性
• Excel中的复杂结构（如多级表头）难以用Markdown原生语法表示
• 双向转换时需要处理编码、特殊字符等兼容性问题

2. 基础转换方案：pandas+tabulate

最基础的转换方案是使用Python的pandas库配合tabulate工具。以下是具体实现步骤：

2.1 安装依赖库

bash复制pip install pandas tabulate

2.2 Excel转Markdown

python复制import pandas as pd

def excel_to_markdown(excel_path, sheet_name=0):
    df = pd.read_excel(excel_path, sheet_name=sheet_name)
    return df.to_markdown(index=False)

# 使用示例
markdown_table = excel_to_markdown("data.xlsx")
print(markdown_table)

2.3 Markdown转Excel

python复制from io import StringIO
import pandas as pd

def markdown_to_excel(markdown_text, output_path):
    # 移除Markdown表格前后的多余内容
    table_lines = [line for line in markdown_text.split('\n') 
                  if line.startswith('|') and line.endswith('|')]
    clean_md = '\n'.join(table_lines)
    
    # 使用StringIO模拟文件对象
    df = pd.read_csv(StringIO(clean_md), sep='|', skipinitialspace=True)
    
    # 清理列名中的空格和|
    df.columns = df.columns.str.strip()
    df = df.dropna(axis=1, how='all')  # 删除空列
    
    # 保存为Excel
    df.to_excel(output_path, index=False)

# 使用示例
with open("table.md") as f:
    markdown_text = f.read()
markdown_to_excel(markdown_text, "output.xlsx")

注意：这种方法对简单的表格效果很好，但无法处理合并单元格、单元格样式等复杂情况。如果表格包含空行或特殊分隔符，可能需要额外处理。

3. 高级转换方案：处理复杂表格

对于更复杂的转换需求，我们需要更强大的工具链。以下是进阶方案：

3.1 使用openpyxl处理Excel样式

python复制from openpyxl import Workbook
from openpyxl.styles import Font, Alignment

def markdown_to_styled_excel(markdown_text, output_path):
    # 基础转换（同前）
    df = markdown_to_dataframe(markdown_text)
    
    # 创建带样式的Excel
    wb = Workbook()
    ws = wb.active
    
    # 写入数据
    for r_idx, row in enumerate(df.itertuples(), 1):
        for c_idx, value in enumerate(row[1:], 1):
            ws.cell(row=r_idx, column=c_idx, value=value)
    
    # 设置样式
    header_font = Font(bold=True)
    for cell in ws[1]:  # 第一行作为表头
        cell.font = header_font
        cell.alignment = Alignment(horizontal='center')
    
    # 自动调整列宽
    for column in ws.columns:
        max_length = 0
        for cell in column:
            try:
                if len(str(cell.value)) > max_length:
                    max_length = len(cell.value)
            except:
                pass
        adjusted_width = (max_length + 2) * 1.2
        ws.column_dimensions[column[0]