| name | md-to-png |
| description | 把 Markdown 文件渲染成手机友好的 HTML，再调用 html-cut 截图为高清 PNG。用户提到 md-to-png、md 转 png、md 截图、把 md 发到手机看时使用。 |
| version | 1.0.0 |
| dependencies | ["python3","html-cut","playwright"] |
| repository | https://github.com/gitByEOS/open-part-skills |
Markdown → PNG
把任意 .md 渲染成 VitePress 风格的自包含 HTML，再借助 html-cut 截图为高清 PNG，方便手机查看或通过聊天工具发送。
启动
python3 scripts/md_to_png.py path/to/skill.md /tmp/out.png
成功时 stdout 仅输出 PNG 绝对路径（与 html-cut 输出约定一致）。
参数
| 参数 | 说明 |
|---|
md | Markdown 文件路径 |
output | PNG 输出路径，可省略，默认写入系统临时目录 |
--title | HTML 标题，默认取 md 首个 # 标题 |
--width | 视口宽度，默认 740（手机阅读友好） |
--height | 视口高度，默认 900 |
--scale | 设备像素比，默认 2 |
--color-scheme | light 或 dark，默认 light |
--wait MS | 加载后额外等待毫秒，默认 500 |
常见示例
python3 scripts/md_to_png.py SKILL.md /tmp/skill.png
python3 scripts/md_to_png.py README.md /tmp/readme.png \
--width 1280 --scale 3 --color-scheme dark
工作流
- 确认输入 md 文件存在
- 脚本自动定位同仓库的
skills/html-cut/scripts/capture.py 做截图
- 执行后检查 stdout 的 PNG 绝对路径，必要时通过 lan-chat 等工具代发给用户
渲染范围
极简 Markdown 转换，覆盖：YAML frontmatter（自动去除）、标题 #、段落、无序列表 -、 fenced 代码块、GFM 表格、行内 code / **bold** / [link](url)。不渲染图片、引用块、有序列表等高级语法。
依赖
- html-cut：截图由
html-cut skill 的 capture.py 完成，需先安装 Playwright 与 Chromium
- 未安装时会以非零退出码报错，按
html-cut SKILL.md 的故障排查处理
注意事项
本 skill 截图依赖同仓库的 html-cut skill
| 现象 | 处理 |
|---|
找不到 html-cut 脚本 | npx skills add https://github.com/gitByEOS/open-part-skills --skill html-cut |
Chromium 找不到 / Executable doesn't exist | python3 -m playwright install chromium |
Agent 注意
- 用户未给输出路径时，输出到临时目录，避免覆盖项目已有文件
- 截图完成后反馈绝对 PNG 路径；不要把二进制图片内容粘进回复
- 若需把截图发给用户，可结合
lan-chat 的代发文件能力
