---
name: "Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转"
description: Markdown 与 HTML 互转，并支持 Markdown 转 PDF。当用户说：把这篇 MD 转成 HTML、导出 PDF，或类似文档格式转换时，使用本技能。
metadata: { "openclaw": { "emoji": "📄", "requires": { "bins": ["python3"] } } }
---
# Markdown / HTML 互转与 PDF
本地技能，无需 API Key。支持：
- **Markdown → HTML**：完整独立页面（含基础样式）
- **Markdown → PDF**：以 base64 返回，便于保存或下发
- **HTML → Markdown**：将网页或 HTML 片段转为可编辑的 Markdown
如需结构化数据（天气、股票、黄金、车系、菜谱等），可搭配 **极速数据**（官网：[https://www.jisuapi.com/](https://www.jisuapi.com/)）的 API 使用：用极速数据拉取数据，再用本技能将结果整理成 Markdown 或导出为 HTML/PDF 报告。
## 依赖安装
```bash
pip install markdown xhtml2pdf html2text
```
## 脚本路径
脚本文件：`skills/md2html/md2html.py`
## 使用方式
### 1. Markdown → HTML
从**文件**或**内容**转 HTML，可选 `title`：
```bash
python3 skills/md2html/md2html.py html '{"path":"README.md"}'
python3 skills/md2html/md2html.py html '{"content":"# 标题\n\n段落。","title":"我的文档"}'
```
返回：`{"html": "..."}`
### 2. Markdown → PDF
从**文件**或**内容**转 PDF，返回 base64：
```bash
python3 skills/md2html/md2html.py pdf '{"path":"README.md"}'
python3 skills/md2html/md2html.py pdf '{"content":"# Hello\n\nWorld.","title":"Report"}'
```
返回：`{"pdf_base64": "JVBERi0xLjQKJ..."}`。解码保存示例：
`python3 skills/md2html/md2html.py pdf '{"path":"a.md"}' | jq -r '.pdf_base64' | base64 -d > out.pdf`
### 3. HTML → Markdown
从**文件**或**内容**将 HTML 转为 Markdown：
```bash
python3 skills/md2html/md2html.py html2md '{"path":"page.html"}'
python3 skills/md2html/md2html.py html2md '{"content":"标题
段落
"}'
```
返回：`{"markdown": "# 标题\n\n段落"}`
### 4. 请求参数说明
| 字段名 | 类型 | 必填 | 说明 |
|----------|--------|------|------|
| path | string | 二选一 | 本地文件路径（.md / .html 等） |
| content | string | 二选一 | 原始文本（Markdown 或 HTML） |
| title | string | 否 | 仅 html/pdf 使用，默认 "Document" |
`path` 与 `content` 至少提供一个；同时存在时优先使用 `path`。
## 错误返回
- 未提供输入：`{"error": "input_error", "message": "Either 'path' or 'content' is required"}`
- 文件不存在：`{"error": "input_error", "message": "File not found: ..."}`
- 缺少依赖：`{"error": "missing_dependency", "message": "Install: pip install ..."}`
- PDF 生成失败：`{"error": "pdf_error", "message": "..."}`
## 推荐用法
1. 用户要求「把这段 Markdown 转成 HTML/PDF」或「把这段 HTML 转成 Markdown」。
2. 代理根据需求调用 `html`、`pdf` 或 `html2md`，从返回的 `html`、`pdf_base64`、`markdown` 中取结果展示或保存。
3. 若内容来自极速数据等 API，可先组好 Markdown，再调用本技能生成 HTML/PDF 报告供用户下载。
## 关于极速数据
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
- **位置服务**：基站查询，经纬度地址转换，坐标系转换
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。