# Converting Markdown
> 将 Markdown 文档转换为精美的 HTML，支持智能 ASCII 图转 SVG。适用场景：(1) 将 Markdown 转换为 HTML 用于演示或文档，(2) 将 ASCII 图（架构图/流程图/UI/时间线）转换为专业 SVG/HTML 图形，(3) 应用专业主题（紫/蓝/绿/极简）生成商务或技术文档。支持 AI 辅助的智能 SVG 转换，3 步流程实现精美图形。 Use when this capability is needed.
- Skill: `tomevault-io/converting-markdown` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/converting-markdown`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/converting-markdown/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/converting-markdown
---
# Converting Markdown to HTML
## Quick Start
```bash
# 指定文件，使用默认主题（purple）
python3 scripts/convert.py document.md
# 指定文件和主题
python3 scripts/convert.py document.md --theme blue
# 列出所有可用主题
python3 scripts/convert.py --list-themes
```
## Features
- ✅ **多主题支持**：purple（紫色）、blue（蓝色）、green（绿色）、corporate（企业蓝）、minimal（极简灰度）
- ✅ 响应式设计（PC/平板/手机）
- ✅ 打印优化（自动移除渐变和阴影）
- ✅ **智能段落合并**：使用专业库，无多余`
`标签
- ✅ **ASCII图清晰显示**：用等宽字体保留，结构准确
- ✅ **智能 SVG 转换**：AI Agent 将 ASCII 图转换为精美 SVG/HTML
- ✅ 稳定的转换逻辑（Python 脚本，依赖 markdown + PyYAML）
---
## ⚠️ 重要约束：UI 图必须静态展示
**对于 UI 类型的 ASCII 图（弹出窗、对话框、表单等）：**
❌ **禁止：**
- 使用 JavaScript 控制显示/隐藏
- 使用 `onclick`、`onhover` 等事件处理
- 使用 `display: none` 隐藏内容
- 需要用户交互才能看到完整内容
- **生成完整的 HTML 文档**（包含 ``, ``, ``, `` 等标签）
✅ **必须：**
- **所有内容直接显示在文档中**
- 使用纯 HTML/CSS，不用 JavaScript
- **生成 HTML 片段（fragment）**，只包含 UI 组件代码
- 目标是**展示设计效果**，不是实现功能
- 适合打印和导出 PDF
**⚠️ HTML 片段规范：**
- ✅ 允许：``, `