#!/usr/bin/env python3
# ============================================
# Markdown 转 HTML 脚本
# 自动转换目录下所有md文件为带样式的HTML
# ============================================
import os
import markdown
from pathlib import Path
# HTML模板
HTML_TEMPLATE = """
{title}
{content}
"""
def convert_md_to_html(md_path, output_dir=None):
"""转换单个markdown文件为HTML"""
md_path = Path(md_path)
# 读取md文件
with open(md_path, 'r', encoding='utf-8') as f:
md_content = f.read()
# 提取标题（第一行）
title = md_path.stem
first_line = md_content.split('\n')[0]
if first_line.startswith('# '):
title = first_line[2:].strip()
# 转换markdown为HTML
html_content = markdown.markdown(
md_content,
extensions=[
'tables',
'fenced_code',
'codehilite',
'toc',
'nl2br'
]
)
# 生成完整HTML
full_html = HTML_TEMPLATE.format(
title=title,
content=html_content
)
# 确定输出路径
if output_dir:
output_path = Path(output_dir) / (md_path.stem + '.html')
else:
output_path = md_path.parent / (md_path.stem + '.html')
# 写入文件
with open(output_path, 'w', encoding='utf-8') as f:
f.write(full_html)
return output_path
def convert_directory(base_dir):
"""批量转换目录下所有md文件"""
base_path = Path(base_dir)
# 查找所有md文件
md_files = list(base_path.rglob('*.md'))
print(f"找到 {len(md_files)} 个 Markdown 文件")
for md_file in md_files:
print(f" 转换: {md_file.relative_to(base_path)}")
output_path = convert_md_to_html(md_file)
print(f" → {output_path.relative_to(base_path)}")
return len(md_files)
if __name__ == '__main__':
import sys
# 检查是否安装了markdown库
try:
import markdown
except ImportError:
print("安装 markdown 库...")
os.system('pip install markdown')
import markdown
# 转换课程目录（绝对路径）
target_dir = "/home/damo/workspace/AIGC_class/2026-2/docs/superpowers/course"
if len(sys.argv) > 1:
target_dir = sys.argv[1]
print("=" * 60)
print(" Markdown → HTML 批量转换工具")
print("=" * 60)
print()
count = convert_directory(target_dir)
print()
print("=" * 60)
print(f" ✅ 转换完成！共转换 {count} 个文件")
print("=" * 60)