"""
将 Markdown 文件转换为 HTML 格式
适用于 Python 3.7 及以上版本
"""
import os
import sys
import codecs
from bs4 import BeautifulSoup
import markdown
import re
import importlib.util
# 检查并安装必要的依赖
required_packages = ['pygments']
for package in required_packages:
if importlib.util.find_spec(package) is None:
print(f"正在安装必要的依赖: {package}")
os.system(f"pip3 install {package}")
from pygments import highlight
from pygments.lexers import get_lexer_by_name, TextLexer
from pygments.formatters import HtmlFormatter
def md_to_html(md_file_path, html_file_path=None, css_file_path=None, title=None):
"""
将 Markdown 文件转换为 HTML 文件
参数:
md_file_path (str): Markdown 文件路径
html_file_path (str, optional): 输出的 HTML 文件路径，默认为与 md 文件同名但扩展名为 .html
css_file_path (str, optional): CSS 文件路径，用于美化 HTML
title (str, optional): HTML 文档的标题，默认使用文件名
返回:
str: 生成的 HTML 文件路径
"""
# 检查 Markdown 文件是否存在
if not os.path.exists(md_file_path):
print(f"错误: Markdown 文件不存在: {md_file_path}")
return None
# 如果未指定 HTML 文件路径，则使用与 md 文件同名但扩展名为 .html 的路径
if html_file_path is None:
html_file_path = os.path.splitext(md_file_path)[0] + '.html'
# 如果未指定标题，则使用文件名作为标题
if title is None:
title = os.path.basename(os.path.splitext(md_file_path)[0])
try:
# 读取 Markdown 文件内容
with codecs.open(md_file_path, 'r', encoding='utf-8') as md_file:
md_content = md_file.read()
# 检查是否包含 [TOC] 标记
has_toc = '[TOC]' in md_content or '[toc]' in md_content
# 预处理 Markdown 内容，处理引用块中的代码块
md_content = preprocess_markdown(md_content)
# 移除 [TOC] 标记，避免在内容中显示
md_content = re.sub(r'\[TOC\]|\[toc\]', '', md_content)
# 转换 Markdown 为 HTML
html_content = markdown.markdown(
md_content,
extensions=[
'markdown.extensions.tables',
'markdown.extensions.fenced_code',
'markdown.extensions.codehilite',
'markdown.extensions.toc',
'markdown.extensions.nl2br',
'markdown.extensions.sane_lists'
],
extension_configs={
'markdown.extensions.codehilite': {
'use_pygments': True,
'noclasses': False,
'css_class': 'highlight'
},
'markdown.extensions.toc': {
'permalink': True,
'baselevel': 1,
'title': '目录',
'toc_depth': 3
}
}
)
# 后处理 HTML 内容，为代码块添加语法高亮
html_content = postprocess_html(html_content)
# 获取 Pygments 样式
pygments_css = HtmlFormatter(style='default').get_style_defs('.highlight')
# 创建完整的 HTML 文档
html_template = f"""
{title}
{'' if css_file_path else ''}
"""
# 如果有 TOC 标记，添加左侧目录
if has_toc:
# 提取标题并生成目录
toc_html = generate_toc(html_content)
html_template += f"""
"""
else:
# 没有 TOC 标记，使用普通布局
html_template += f"""