Python操作Markdown格式文件的全攻略

 更新时间:2026年03月25日 09:48:36   作者:MediaTea  
Markdown 是一种轻量级标记语言,用于以纯文本形式编写格式化文档,广泛应用于技术文档,博客,笔记管理以及学术写作等场景,下面我们就来看看如何使用Python操作Markdown格式文件吧

Markdown 是一种轻量级标记语言,用于以纯文本形式编写格式化文档。

它使用简洁的符号表示标题、列表、表格、链接、代码块等结构,易于阅读与编辑,同时可通过渲染生成 HTML、PDF、幻灯片等格式。

Markdown 广泛应用于技术文档、博客、GitHub README、笔记管理以及学术写作等场景。

一、Markdown 格式特点

Markdown 文件扩展名通常为 .md 或 .markdown。

主要特点:

(1)纯文本

文件内容可直接在任何文本编辑器中查看。

(2)可读性强

即使不渲染,也能理解文档结构。

(3)轻量化标记

使用符号表示格式,如 # 表示标题,* 或 - 表示列表。

(4)可扩展

支持表格、脚注、数学公式(需扩展)、代码高亮等。

(5)跨平台

兼容 Git、博客平台、文档生成器等。

示例 Markdown 内容:

# 学生成绩表| ID | Name  | Score ||----|-------|-------|| 1  | Alice | 95    || 2  | Bob   | 88    || 3  | Carol | 90    |- 高分学生:成绩 >= 90- 平均分:91.0> 注:Markdown 文件支持引用、列表、表格及代码块。

该示例展示了 Markdown 的基本语法:标题、表格、列表与引用。

二、在 Python 中表示 Markdown 数据

(1)使用字符串与内存文件对象

当我们想在内存中操作 Markdown,而不立即写入磁盘时,可使用 io.StringIO。

from io import StringIO
md_text = """# 学生成绩表
| ID | Name  | Score ||----|-------|-------|| 1  | Alice | 95    || 2  | Bob   | 88    || 3  | Carol | 90    |"""
# 创建内存中文本文件对象buf = StringIO(md_text)print(buf.read())

StringIO 适合测试、临时存储或处理网络请求中的 Markdown 内容。

(2)使用列表/字典在内存中表示表格数据

在生成 Markdown 表格前,通常先在内存中准备数据:

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

这种结构便于程序化生成 Markdown 表格或列表。

三、使用 Python 标准库生成 Markdown

虽然 Python 标准库没有专门的 Markdown 模块,但可以直接通过字符串操作生成 Markdown 文件。

(1)生成 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']} |")
# 写入 Markdown 文件
with open("students.md", "w", encoding="utf-8") as f:    f.write("\n".join(md_lines))
print("students.md 文件已保存。")

输出 Markdown 文件内容:

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

(2)生成标题、列表与代码块

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 文件已保存。")

生成文件可直接渲染为带列表和代码块的 Markdown 文档。

四、使用第三方库处理 Markdown

(1)将 Markdown 转换为 HTML

import markdown
with open("students.md", "r", encoding="utf-8") as f:    md_content = f.read()
html_content = markdown.markdown(md_content)
# 保存 HTML 文件
with open("students.html", "w", encoding="utf-8") as f:    f.write(html_content)
print("students.html 已生成,可在浏览器中查看。")

说明:markdown 库支持表格、代码块、标题和列表渲染为 HTML,方便展示。

(2)使用 pandas 直接生成 Markdown 表格

import pandas as pd
df = pd.DataFrame(students)
# 生成 Markdown 表格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)

输出示例:

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

pandas to_markdown 方法可快速将 DataFrame 输出为 Markdown 表格。

(3)案例:Markdown 文件生成与分析

以下示例展示从内存数据 → Markdown 表格 → HTML 渲染 → 保存文件的完整流程。

import pandas as pdimport 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 文件内容示例:

# 高分学生表|   id | Name  |   score ||------|-------|---------||    1 | Alice |      95 ||    3 | Carol |      90 |

五、解析 Markdown 文件并提取内容

在某些场景下,我们需要读取并解析 Markdown 内容,将标题、列表、表格或代码块转换为 Python 数据结构,以便进一步分析。

(1)使用 markdown + BeautifulSoup 提取 HTML 内容

import markdownfrom bs4 import BeautifulSoup
# 读取 Markdown 文件
with open("top_students.md", "r", encoding="utf-8") as f:    md_content = f.read()
# 渲染为 HTML
html_content = markdown.markdown(md_content)
# 使用 BeautifulSoup 解析 HTML
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)

输出示例:

标题: 高分学生表表格内容:['id', 'Name', 'score']['1', 'Alice', '95']['3', 'Carol', '90']

(2)使用正则表达式(re 标准库)提取表格内容

import re
with open("top_students.md", "r", encoding="utf-8") as f:    md_content = f.read()
# 匹配 Markdown 表格行
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 方法。

(3)案例:Markdown 表格 → Python 数据 → 数据分析

import pandas as pdimport markdownfrom bs4 import BeautifulSoup
# 读取 Markdown 并渲染为 HTML
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)
# 转换为 DataFrame
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}")

运行结果:

id   Name  score0   1  Alice     951   3  Carol     90平均分:92.5

小结

Markdown 是轻量级、可读性强、跨平台的文档格式。Python 标准库通过字符串操作即可生成 Markdown 文件。

第三方库 markdown 可将 Markdown 渲染为 HTML,方便展示和解析。pandas to_markdown 方法可快速生成 Markdown 表格。

综合流程包括:生成 Markdown → 渲染/解析 → 转换数据结构 → 数据分析 → 输出结果,适合文档化与数据处理相结合的场景。

到此这篇关于Python操作Markdown格式文件的全攻略的文章就介绍到这了,更多相关Python操作Markdown文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Django框架实现逆向解析url的方法

    Django框架实现逆向解析url的方法

    这篇文章主要介绍了Django框架实现逆向解析url的方法,结合实例形式分析了Django逆向解析URL的原理、步骤、相关实现技巧与注意事项,需要的朋友可以参考下
    2018-07-07
  • 对python中不同模块(函数、类、变量)的调用详解

    对python中不同模块(函数、类、变量)的调用详解

    今天小编就为大家分享一篇对python中不同模块(函数、类、变量)的调用详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-07-07
  • python中pd.cut()与pd.qcut()的对比及示例

    python中pd.cut()与pd.qcut()的对比及示例

    本文主要介绍了python中pd.cut()与pd.qcut()的对比及示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • Python读大数据txt

    Python读大数据txt

    本文通过2个例子给大家介绍了如何使用python实现读取大文件txt的方法,有需要的小伙伴可以参考下
    2016-03-03
  • python 调整图片亮度的示例

    python 调整图片亮度的示例

    这篇文章主要介绍了python 调整图片亮度的示例代码,帮助大家更好的利用python处理图片,感兴趣的朋友可以了解下
    2020-12-12
  • python实现批量转换文件编码(批转换编码示例)

    python实现批量转换文件编码(批转换编码示例)

    这篇文章主要介绍了python实现批量转换文件编码示例,指定文件编码、目录或扩展名即可进行转换,大家参考使用吧
    2014-01-01
  • 使用Python实现异步文件读写功能

    使用Python实现异步文件读写功能

    在处理大规模数据或多个文件时,同步读写操作会导致程序阻塞,影响整体性能,通过异步文件读写,可以显著提高程序的响应速度和并发处理能力,本文将详细介绍如何使用Python实现异步文件读写,需要的朋友可以参考下
    2025-09-09
  • python 获取键盘输入,同时有超时的功能示例

    python 获取键盘输入,同时有超时的功能示例

    今天小编就为大家分享一篇python 获取键盘输入,同时有超时的功能示例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-11-11
  • Python序列对象与String类型内置方法详解

    Python序列对象与String类型内置方法详解

    这篇文章主要介绍了Python序列对象与String类型内置方法,结合实例形式分析了Python序列对象与String类型各种常见内置方法相关使用技巧及操作注意事项,需要的朋友可以参考下
    2019-10-10
  • PyPy 如何让Python代码运行得和C一样快

    PyPy 如何让Python代码运行得和C一样快

    这篇文章主要介绍了如何让Python代码运行得和C一样快,由于 PyPy 只是 Python 的一种替代实现,大多数时候它都是开箱即用,无需对 Python 项目进行任何更改。它与 Web 框架 Django、科学计算包 Numpy 和许多其他包完全兼容,推荐大家多多使用
    2022-01-01

最新评论