用途:将任意 .md 文件渲染为 VitePress 风格的自包含 HTML,再借助 html-cut 截图为高清 PNG,方便手机阅读或通过聊天工具发送。
主要能力:支持 YAML frontmatter(自动去除)、标题、段落、无序列表、fenced 代码块、GFM 表格、行内 code、粗体与链接。不渲染图片、引用块、有序列表等高级语法。
使用方式:运行 python3 scripts/md_to_png.py path/to/skill.md /tmp/out.png。成功时 stdout 仅输出 PNG 绝对路径。参数包括 md(Markdown 路径)、output(PNG 输出路径,可省略,默认写入系统临时目录)、--title(默认取首个 # 标题)、--width(默认 740)、--height(默认 900)、--scale(默认 2)、--color-scheme(light 或 dark,默认 light)、--wait(默认 500 毫秒)。示例:python3 scripts/md_to_png.py README.md /tmp/readme.png --width 1280 --scale 3 --color-scheme dark。
依赖与限制:截图依赖同仓库的 html-cut skill 的 capture.py,需先安装 Playwright 与 Chromium;未安装会以非零退出码报错。找不到 html-cut 脚本时可执行 npx skills add https://github.com/gitByEOS/open-part-skills --skill html-cut;Chromium 缺失时执行 python3 -m playwright install chromium。用户未给输出路径时输出到临时目录,避免覆盖项目文件;完成后反馈绝对 PNG 路径,不要把二进制图片内容粘进回复。