主流 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正文内容")

如何选择？

1. 如果你需要丰富的扩展功能，选择 python-markdown
2. 如果你注重性能，选择 mistune
3. 如果你想要简单易用，选择 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 = """
        html>
        
        
            
            
            
        
        
            

                
{title}

                

                    发布日期：{date}
                    标签：{tags}
                

                

                    {content}
                

            

        
        
        """
        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()

使用说明：

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

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



这是文章正文...

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

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

往期精彩回顾







    
写了一本适合本科生的机器学习入门书
适合初学者入门人工智能的路线及资料下载
(图文+视频)机器学习入门系列下载
机器学习及深度学习笔记等资料打印
《统计学习方法》的代码复现专辑
交流群
请备注：”昵称-学校/公司-研究方向“，例如：”张小明-浙大-CV“加群。
（也可以加入机器学习交流qq群772479961）