Python实现Markdown生成HTML的详细教程

# 基础安装（适用于Python 3.x）
pip install markdown
# 若存在多个Python版本，指定pip3
pip3 install markdown

# 导入markdown库
import markdown
# 1. 定义待转换的Markdown文本
md_text = """
# 这是一级标题
这是**加粗**的文本，这是*斜体*的文本。
## 这是二级标题
- 无序列表项1
- 无序列表项2
- 无序列表项3
[点击访问xcLeigh博客](https://xcleigh.blog.csdn.net/) 查看更多资源。
"""
# 2. 调用markdown.markdown()函数转换
html_output = markdown.markdown(md_text)
# 3. 打印转换后的HTML结果
print("转换后的HTML：")
print("-" * 50)
print(html_output)

<h1>这是一级标题</h1>
<p>这是<strong>加粗</strong>的文本，这是<em>斜体</em>的文本。</p>
<h2>这是二级标题</h2>
<ul>
<li>无序列表项1</li>
<li>无序列表项2</li>
<li>无序列表项3</li>
</ul>
<p><a href="https://www.runoob.com" rel="external nofollow" >点击访问菜鸟教程</a> 查看更多资源。</p>

# 项目说明文档
## 项目简介
这是一个用Python实现Markdown转HTML的示例项目。
## 功能列表
1. 支持基础Markdown语法转换
2. 可批量处理Markdown文件
3. 支持扩展功能（表格、代码高亮）
## 表格示例
| 功能       | 状态 | 备注         |
|------------|------|--------------|
| 文本加粗   | ✅    | 支持**加粗** |
| 列表       | ✅    | 支持有序/无序 |
| 表格       | ❌    | 需启用扩展   |

import markdown

def md_to_html(md_file_path, html_file_path):
    """
    将Markdown文件转换为HTML文件
    :param md_file_path: Markdown文件路径
    :param html_file_path: 输出HTML文件路径
    """
    # 1. 读取Markdown文件（指定utf-8编码避免中文乱码）
    try:
        with open(md_file_path, 'r', encoding='utf-8') as md_file:
            md_content = md_file.read()
        print(f"成功读取Markdown文件：{md_file_path}")
    except FileNotFoundError:
        print(f"错误：未找到文件 {md_file_path}")
        return

    # 2. 转换Markdown为HTML（暂不启用扩展）
    html_content = markdown.markdown(md_content)

    # 3. 将HTML内容写入文件
    with open(html_file_path, 'w', encoding='utf-8') as html_file:
        html_file.write(html_content)
    print(f"HTML文件已生成：{html_file_path}")

# 调用函数：转换example.md为example.html
if __name__ == "__main__":
    md_to_html("example.md", "example.html")

python convert_md_to_html.py

成功读取Markdown文件：example.md
HTML文件已生成：example.html

# 原代码：html_content = markdown.markdown(md_content)
# 修改后：启用tables（表格）和fenced_code（代码块）扩展
html_content = markdown.markdown(
    md_content,
    extensions=['tables', 'fenced_code']  # 启用两个常用扩展
)

## 代码块示例（启用扩展后支持）
# 计算1+1
result = 1 + 1
print(f"1+1={result}")

# 运行Python脚本
python convert_md_to_html.py

pip install pygments

html_content = markdown.markdown(
    md_content,
    extensions=['tables', 'fenced_code', 'codehilite']  # 新增codehilite
)