核心用法
markdown-convert 是一款纯本地运行的文档格式转换技能，无需外部API Key，依赖Python生态实现Markdown、HTML、PDF三种格式的灵活互转。
功能模块
| 模式 | 输入源 | 输出 | 典型场景 |
|------|--------|------|----------|
| `html` | 本地文件或原始内容 | 完整HTML页面（含基础样式） | 生成可预览的独立网页 |
| `pdf` | 本地文件或原始内容 | base64编码的PDF | 生成可下载的正式报告 |
| `html2md` | 本地文件或HTML片段 | 标准Markdown | 网页内容抓取与再编辑 |
显著优点
1. 零API成本：完全本地执行，无外部服务依赖，适合高频批量处理
2. 双源输入：同时支持path（文件路径）和content（直接文本），灵活适配工作流
3. 即插即用：与极速数据等API搭配，可将结构化数据快速渲染为可视化报告
4. 安全可控：文件操作限定本地路径，无网络外泄风险
潜在局限
- 样式基础：PDF生成依赖
xhtml2pdf，复杂CSS布局支持有限，专业排版需后期调整 - 依赖管理：需预装
markdown、xhtml2pdf、html2text三个Python包 - 无实时预览：返回base64需客户端解码，不像在线工具即时可视化
适合人群
- 需要将API数据（天气、股票、菜谱等）快速导出PDF报告的自动化场景
- 重视数据隐私、偏好本地处理的敏感文档处理用户
- 构建内容工作流的技术用户（搭配CI/CD或批量脚本）
常规风险
- 路径遍历：若外部传入
path参数未校验，可能读取系统任意文件（建议限定工作目录） - 依赖漏洞：
xhtml2pdf等第三方库需定期更新以修复已知安全问题 - XSS残留：HTML→Markdown转换时，若源HTML含恶意脚本，转换后仍可能保留（建议输出前做内容过滤）