【Python】用 Python 把 Markdown 玩的明明白白

最新推荐文章于 2025-06-26 14:32:21 发布

风度78

最新推荐文章于 2025-06-26 14:32:21 发布

阅读量1.3k

点赞数

CC 4.0 BY-SA版权

文章标签： python sqlite 开发语言数据库

原文链接：https://mp.weixin.qq.com/s?__biz=MzIwODI2NDkxNQ==&mid=2247522824&idx=2&sn=13d758cf62574b72927ae58227ff13dc&chksm=96eab2f869dda4688391a4a8bff37a6ba273788707e8fe9d51de91bef781dda680735972e2a9&scene=126&sessionid=0

作为一名开发者，Markdown 的使用是必备技能。无论是写技术文档、博客文章，还是项目 README，Markdown 都是得力助手。

Python 作为一门强大的编程语言，提供了丰富的工具来处理和转换 Markdown 内容。本文将为大家介绍 Python 生态中最常用的 Markdown 处理库，帮助你选择合适的工具，并通过实战案例展示如何在实际项目中运用这些库。

主流 `Markdown` 处理库

`python`-`markdown`

最受欢迎的 Markdown 解析库，Django 文档系统的默认选择。

主要特点：

扩展系统丰富
完全符合标准 Markdown 语法
支持自定义扩展
文档完善

基础用法：

import markdown

text = "# 标题\n这是一段**加粗**的文字"
html = markdown.markdown(text)

`mistune`

主要特点：

性能出色
安全性好
扩展性强
代码简洁

基础用法：

import mistune

markdown = mistune.create_markdown()
html = markdown("# 标题\n正文内容")

markdown2

主要特点：

使用简单
功能适中
适合小型项目
安装依赖少

基础用法：

import markdown2

html = markdown2.markdown("# 标题\n正文内容")

如何选择？

如果你需要丰富的扩展功能，选择 python-markdown
如果你注重性能，选择 mistune
如果你想要简单易用，选择 markdown2

实战案例——博客生成器

下面通过一个实际案例，演示如何使用 python-markdown 构建一个简单的技术博客生成器。

这个案例中，实现了：

Markdown 解析和转换
元数据处理
文件操作
HTML 模板生成
批量处理功能

import markdown
import os
from datetime import datetime

class BlogGenerator:
    def __init__(self, posts_dir, output_dir):
        self.posts_dir = posts_dir
        self.output_dir = output_dir
        self.md = markdown.Markdown(extensions=[
            'meta',           # 支持元数据
            'fenced_code',    # 支持代码块
            'tables',         # 支持表格
            'toc'            # 支持目录
        ])
    
    def read_post(self, filename):
        with open(os.path.join(self.posts_dir, filename), 'r', encoding='utf-8') as f:
            content = f.read()
        
        # 转换内容并获取元数据
        html = self.md.convert(content)
        meta = self.md.Meta if hasattr(self.md, 'Meta') else {}
        
        return {
            'content': html,
            'title': meta.get('title', ['无标题'])[0],
            'date': meta.get('date', [datetime.now().strftime('%Y-%m-%d')])[0],
            'tags': meta.get('tags', [])[0].split(',') if meta.get('tags') else []
        }
    
    def generate_html(self, post_data):
        template = """
        <!DOCTYPE html>
        <html>
        <head>
            <meta charset="utf-8">
            <title>{title}</title>
            <link rel="stylesheet" href="style.css">
        </head>
        <body>
            <article>
                <h1>{title}</h1>
                <div class="meta">
                    <span>发布日期：{date}</span>
                    <span>标签：{tags}</span>
                </div>
                <div class="content">
                    {content}
                </div>
            </article>
        </body>
        </html>
        """
        return template.format(
            title=post_data['title'],
            date=post_data['date'],
            tags=', '.join(post_data['tags']),
            content=post_data['content']
        )
    
    def generate_blog(self):
        # 确保输出目录存在
        os.makedirs(self.output_dir, exist_ok=True)
        
        # 处理所有 markdown 文件
        for filename in os.listdir(self.posts_dir):
            if filename.endswith('.md'):
                # 读取并处理文章
                post_data = self.read_post(filename)
                
                # 生成 HTML 文件
                output_file = os.path.join(
                    self.output_dir, 
                    filename.replace('.md', '.html')
                )
                
                with open(output_file, 'w', encoding='utf-8') as f:
                    f.write(self.generate_html(post_data))

# 使用示例
if __name__ == '__main__':
    generator = BlogGenerator('posts', 'output')
    generator.generate_blog()

使用说明：

创建一个posts目录存放 Markdown 文章
文章格式示例：

---
title: Python 学习笔记
date: 2024-12-12
tags: Python，编程，学习
---



这是文章正文...

运行脚本，将在output目录生成对应的 HTML 文件

通过这个实例，你可以看到 python-markdown 强大的扩展系统和元数据处理能力，这也是为什么它特别适合构建文档系统和博客平台的原因。

往期精彩回顾




写了一本适合本科生的机器学习入门书适合初学者入门人工智能的路线及资料下载(图文+视频)机器学习入门系列下载机器学习及深度学习笔记等资料打印《统计学习方法》的代码复现专辑

```
交流群
```

请备注：”昵称-学校/公司-研究方向“，例如：”张小明-浙大-CV“加群。

（也可以加入机器学习交流qq群772479961）

【Python】用 Python 把 Markdown 玩的明明白白

主流 Markdown 处理库

python-markdown

mistune

markdown2

实战案例——博客生成器

主流 `Markdown` 处理库

`python`-`markdown`

`mistune`