Markdown to HTML Converter

一键将 Markdown 文档转换为精美 HTML 网页，支持 4 套专业模板

---

核心特性

• 4 套颜色模板：蓝色 / 红色 / 绿色 / 紫色
• 专业排版：渐变背景、卡片布局、代码高亮
• 完整转换：标题、段落、表格、列表、代码块
• 图片优化：自动居中、圆角边框、阴影效果
• 响应式设计：适配所有屏幕
• 5-10 秒转换：纯本地 Python 脚本

---

支持的模板

模板	颜色	适用场景
blue	深蓝色	学术报告、技术文档
red	深红色	专业报告，投资建议
green	深绿色	自然主题、环保文档
purple	深紫色	优雅风格、创意文档

---

快速开始

安装依赖

pip install markdown

使用方法

# 使用蓝色模板（默认）
python scripts/md2html_pro.py 输入文件.md

# 指定输出文件和模板
python scripts/md2html_pro.py 输入文件.md 输出文件.html red

# 使用绿色模板
python scripts/md2html_pro.py 输入文件.md 输出文件.html green

# 使用紫色模板
python scripts/md2html_pro.py 输入文件.md 输出文件.html purple

---

支持的元素

• 标题 (H1-H6)
• 段落 (粗体、斜体)
• 列表 (有序、无序)
• 表格 (自动修复格式)
• 代码块 (语法高亮)
• 引用块
• 链接
• 图片 (居中+阴影)

---

功能特点

• 渐变背景 + 白色卡片布局
• 响应式设计 (最大宽度 1400px)
• 专业表格样式 (渐变表头+斑马纹)
• 图片自动居中 + 圆角边框
• 代码高亮
• 悬停效果

---

工作流示意

Markdown (.md)
    ↓
HTML + CSS模板
    ↓
精美网页 (.html)

---

项目结构

markdown-to-html/
├── README.md               # 本文档
├── SKILL.md                # 技能说明
├── scripts/
│   ├── md2html_pro.py     # 核心转换脚本
│   └── check_images.py     # 图片检查脚本
└── templates/
    ├── blue.html           # 蓝色模板
    ├── red.html           # 红色模板
    ├── green.html         # 绿色模板
    └── purple.html        # 紫色模板

---

转换效果示例

蓝色模板 (blue)

适合学术报告、技术文档 - 深蓝色渐变背景，专业稳重

红色模板 (red)

适合专业报告、投资建议 - 深红色强调，重点突出

绿色模板 (green)

适合自然主题、环保文档 - 深绿色清新，自然舒适

紫色模板 (purple)

适合优雅风格、创意文档 - 深紫色典雅，品味高端

---

与其他工具对比

功能	markdown-to-html	Pandoc	其他工具
模板选择	4套专业模板	无	无
样式质量	企业级	基础	基础
图片美化	自动优化	无	无
转换速度	5-10秒	1-3秒	1-5秒
学习成本	零学习	中等	低

---

技术实现

核心技术栈

• markdown - Markdown 解析
• Jinja2 模板引擎 - CSS 模板应用
• 原生 HTML5 + CSS3

转换流程

1. 读取 Markdown 文件
2. 预处理表格格式（自动修复）
3. Markdown → HTML 转换
4. 套用 CSS 模板
5. 输出 HTML 文件

---

最佳实践

图片处理

• 推荐格式：PNG、JPG
• 推荐尺寸：800x450px
• 文件大小：20KB-100KB
• 路径：使用相对路径

表格格式

| 表头1 | 表头2 |
|-------|-------|
| 数据1 | 数据2 |

---

许可证

MIT License - 自由使用、修改和分发

---

作者

Claw - 董事长助理 AI