将 Markdown 文档转换为精美 PNG 图片。当用户要求将 markdown 文件、markdown 文本转成图片、截图、png 时触发。支持多种主题（note/dark/sakura/ocean/tech 等）和尺寸（mobile/tablet/laptop/desktop

将 Markdown 文档转换为精美 PNG 图片。仅操作当前工作目录下的 Markdown 文件，不修改系统文件。当用户要求将 markdown 文件、markdown 文本转成图片、截图、png 时触发。支持多种主题（note/dark/sakura/ocean/tech 等）和尺寸（mobile/tablet/laptop/desktop）。

QiuYi@qiulanzhu

Install

openclaw skills install @qiulanzhu/md2png

md2png — Markdown 转 PNG 图片

将 Markdown 内容渲染为精美的 PNG 图片，支持 10 种主题和 4 种尺寸。

使用方式

用户通过 /md2png 调用，传入参数 $ARGUMENTS。

执行步骤

解析参数：从 $ARGUMENTS 中识别：
- Markdown 文件路径或直接文本内容（必填）
- -t 或 --theme：主题名称（可选，默认 note）
- -s 或 --size：尺寸规格（可选，默认 tablet）
- -o 或 --output：输出文件名（可选，默认 output.png）
参数白名单校验（校验不通过则拒绝执行并提示用户）：
- theme 必须是以下之一：note vitality gradient antiquity classic dark minimal sakura ocean tech
- size 必须是以下之一：mobile tablet laptop desktop
- output 文件名只允许字母、数字、连字符、下划线和 .png 后缀（如 my-output.png）
- 若 input 为文件路径，必须是相对路径且仅限当前目录下的文件，禁止包含 ../、./ 以外的层级跳转及绝对路径
检查输入：
- 如果参数是文件路径，用 Glob 或 Read 工具确认文件存在于当前目录
- 如果参数为空，提示用户提供 Markdown 文件路径或文本
检查本地安装：执行前先确认 md2png-cli@1.0.2 已在本地安装：
text
```
npx --no-install md2png-cli --version
```
- 若命令失败（退出码非 0），停止执行，提示用户先运行以下命令安装后再重试：
  text
```
npm install -g md2png-cli@1.0.2
```
- 不得跳过此检查自动联网下载
执行转换：确认本地已安装后，使用 --no-install 标志执行，防止运行时触发网络下载：
text
```
npx --no-install md2png-cli <输入文件路径> -t <主题> -s <尺寸> -o <输出文件名>
```
- 如果输入是文件路径，直接传入（已通过校验的相对路径）
- 如果输入是文本内容，禁止将原始文本直接拼接进 Bash 命令（防止 Shell 注入）。必须先用 Write 工具将文本写入当前目录下的临时文件（如 _md2png_tmp.md），再将该文件路径传给命令；转换完成后用 Bash 删除该临时文件
展示结果：
- 告知用户图片已生成及保存路径
- 用 Read 工具读取生成的 PNG 图片，展示给用户预览

可用主题

主题	名称	风格
`note`	便签	暖黄便签风格，适合笔记
`vitality`	元气	蓝紫渐变，活泼明亮
`gradient`	渐变	粉绿渐变，清新自然
`antiquity`	古风	古典纹理，国风韵味
`classic`	经典	灰色背景，简约大方
`dark`	暗黑	深色主题，适合代码
`minimal`	极简	浅灰渐变，干净利落
`sakura`	樱花	粉色渐变，浪漫唯美
`ocean`	海洋	蓝色渐变，沉稳大气
`tech`	科技	赛博朋克，荧光酷炫

可用尺寸

尺寸	名称	宽度
`mobile`	移动端	20rem
`tablet`	平板端	28rem
`laptop`	电脑端	50rem
`desktop`	超级屏	60rem

示例

/md2png README.md — 用默认主题转换文件
/md2png README.md -t dark -o readme.png — 暗黑主题输出为 readme.png
/md2png "# Hello World" -t sakura -s mobile — 樱花主题移动端尺寸