Python 处理 Markdown 文件：生成、转换与解析实战

students = [
    {"id": 1, "name": "Alice", "score": 95},
    {"id": 2, "name": "Bob", "score": 88},
    {"id": 3, "name": "Carol", "score": 90},
]

# 构建表头
md_lines = ["| ID | Name | Score |", "|----|------|-------|"]

# 逐行添加数据
for s in students:
    md_lines.append(f"| {s['id']} | {s['name']} | {s['score']} |")

# 写入文件
with open("students.md", "w", encoding="utf-8") as f:
    f.write("\n".join(md_lines))

print("students.md 文件已保存。")

生成的文件内容如下，直接可用浏览器或编辑器查看：

| ID | Name | Score |
|----|------|-------|
| 1 | Alice | 95 |
| 2 | Bob | 88 |
| 3 | Carol | 90 |

组合标题、列表与代码块

除了表格，我们还可以动态生成标题、嵌套列表甚至代码块：

students = [
    {"id": 1, "name": "Alice", "score": 95},
    {"id": 2, "name": "Bob", "score": 88},
    {"id": 3, "name": "Carol", "score": 90},
]

md_lines = []

# 标题
md_lines.append("# 学生成绩分析")

# 筛选高分学生并生成列表
top_students = [s for s in students if s["score"] >= 90]
md_lines.append("- 高分学生：")
for s in top_students:
    md_lines.append(f"  - {s['name']}：{s['score']}")

# 插入代码块
md_lines.append("\n```python")
md_lines.append("print('Hello, Markdown!')")
md_lines.append("```")

# 写入文件
with open("analysis.md", "w", encoding="utf-8") as f:
    f.write("\n".join(md_lines))

print("analysis.md 已保存。")

这样生成的文档既包含结构化数据，也有可执行的代码片段，非常适合技术报告。

第三方库增强功能

转换为 HTML

如果需要在网页展示，可以使用 markdown 库将 Markdown 渲染为 HTML：

import markdown

with open("students.md", "r", encoding="utf-8") as f:
    md_content = f.read()

html_content = markdown.markdown(md_content)

with open("students.html", "w", encoding="utf-8") as f:
    f.write(html_content)

print("students.html 已生成，可在浏览器中查看。")

这个库支持表格、代码高亮和标题渲染，比纯文本更直观。

Pandas 快速生成表格

处理表格数据时，Pandas 的 to_markdown() 方法非常高效：

import pandas as pd

df = pd.DataFrame(students)
md_table = df.to_markdown(index=False)
print(md_table)

with open("students_table.md", "w", encoding="utf-8") as f:
    f.write(md_table)

输出结果会自动对齐列宽，省去了手动计算分隔符的麻烦。

完整流程案例

结合上述方法，我们可以实现从内存数据到 Markdown 再到 HTML 的完整链路：

import pandas as pd
import markdown

students = [
    {"id": 1, "name": "Alice", "score": 95},
    {"id": 2, "name": "Bob", "score": 88},
    {"id": 3, "name": "Carol", "score": 90},
    {"id": 4, "name": "David", "score": 70},
]

df = pd.DataFrame(students)
top_students = df[df["score"] >= 90]

# 生成 Markdown
md_lines = ["# 高分学生表", top_students.to_markdown(index=False)]
with open("top_students.md", "w", encoding="utf-8") as f:
    f.write("\n".join(md_lines))

# 渲染为 HTML
with open("top_students.md", "r", encoding="utf-8") as f:
    md_content = f.read()

html_content = markdown.markdown(md_content)
with open("top_students.html", "w", encoding="utf-8") as f:
    f.write(html_content)

print("top_students.md 与 top_students.html 已生成。")

解析 Markdown 提取内容

有时候我们需要反向操作：读取 Markdown 文件，把里面的表格或标题转回 Python 数据结构以便分析。

使用 BeautifulSoup 解析 HTML

先渲染为 HTML，再用 BeautifulSoup 提取元素比较稳健：

import markdown
from bs4 import BeautifulSoup

with open("top_students.md", "r", encoding="utf-8") as f:
    md_content = f.read()

html_content = markdown.markdown(md_content)
soup = BeautifulSoup(html_content, "html.parser")

# 提取标题
title = soup.find(["h1", "h2", "h3"])
print("标题：", title.text)

# 提取表格
table = soup.find("table")
rows = []
for tr in table.find_all("tr"):
    cells = [td.get_text(strip=True) for td in tr.find_all(["th", "td"])]
    rows.append(cells)

print("表格内容：")
for r in rows:
    print(r)

这种方法能准确获取层级结构，适合复杂文档。

正则表达式提取表格

对于简单的表格，直接用正则匹配速度更快：

import re

with open("top_students.md", "r", encoding="utf-8") as f:
    md_content = f.read()

lines = md_content.splitlines()
table_rows = []

for line in lines:
    # 跳过标题行和分割线
    if "|" in line and not re.match(r"^\s*#|^-{2,}", line):
        cells = [cell.strip() for cell in line.strip("|").split("|")]
        table_rows.append(cells)

print("解析表格：")
for row in table_rows:
    print(row)

注意：正则法不适合嵌套结构或复杂 Markdown，遇到多级列表或代码块时，推荐 HTML 渲染 + BeautifulSoup 方案。

数据分析实战

将解析出的表格转为 DataFrame 后，就能直接做统计了：

import pandas as pd
import markdown
from bs4 import BeautifulSoup

with open("top_students.md", "r", encoding="utf-8") as f:
    md_content = f.read()

html_content = markdown.markdown(md_content)
soup = BeautifulSoup(html_content, "html.parser")

table = soup.find("table")
rows = []
for tr in table.find_all("tr"):
    cells = [td.get_text(strip=True) for td in tr.find_all(["th", "td"])]
    rows.append(cells)

df = pd.DataFrame(rows[1:], columns=rows[0])
df["score"] = df["score"].astype(int)

avg_score = df["score"].mean()
print(df)
print(f"平均分：{avg_score:.1f}")

运行结果会显示表格数据和平均分，实现了从文档到数据的闭环。

小结

Markdown 凭借轻量、可读性强和跨平台特性，成为技术文档的首选。Python 标准库足以应对基础的生成需求，而 markdown 和 pandas 等第三方库则能大幅提升效率。无论是生成报告还是解析现有文档，掌握这些技巧都能让数据处理工作更加自动化。