Markdown / HTML 互转与 PDF

本地技能，无需 API Key。支持：

• Markdown → HTML：完整独立页面（含基础样式）
• Markdown → PDF：以 base64 返回，便于保存或下发
• HTML → Markdown：将网页或 HTML 片段转为可编辑的 Markdown

如需结构化数据（天气、股票、黄金、车系、菜谱等），可搭配 极速数据（官网：https://www.jisuapi.com/）的 API 使用：用极速数据拉取数据，再用本技能将结果整理成 Markdown 或导出为 HTML/PDF 报告。

依赖安装

pip install markdown xhtml2pdf html2text

脚本路径

脚本文件：skills/md2html/md2html.py

使用方式

1. Markdown → HTML

从文件或内容转 HTML，可选 title：

python3 skills/md2html/md2html.py html '{"path":"README.md"}'
python3 skills/md2html/md2html.py html '{"content":"# 标题nn段落。","title":"我的文档"}'

返回：{"html": "..."}

2. Markdown → PDF

从文件或内容转 PDF，返回 base64：

python3 skills/md2html/md2html.py pdf '{"path":"README.md"}'
python3 skills/md2html/md2html.py pdf '{"content":"# HellonnWorld.","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：

python3 skills/md2html/md2html.py html2md '{"path":"page.html"}'
python3 skills/md2html/md2html.py html2md '{"content":"
标题
段落
"}'

返回：{"markdown": "# 标题nn段落"}

4. 请求参数说明

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） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。