md2png（md2png 文档）

md2png — Markdown 转 PNG 图片

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

使用方式

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

执行步骤

1. 解析参数：从 $ARGUMENTS 中识别：

- Markdown 文件路径或直接文本内容（必填） - -t 或 --theme：主题名称（可选，默认 note） - -s 或 --size：尺寸规格（可选，默认 tablet） - -o 或 --output：输出文件名（可选，默认 output.png）

1. 参数白名单校验（校验不通过则拒绝执行并提示用户）：

- theme 必须是以下之一：note vitality gradient antiquity classic dark minimal sakura ocean tech - size 必须是以下之一：mobile tablet laptop desktop - output 文件名只允许字母、数字、连字符、下划线和 .png 后缀（如 my-output.png） - 若 input 为文件路径，必须是相对路径且仅限当前目录下的文件，禁止包含 ../、./ 以外的层级跳转及绝对路径

1. 检查输入：

- 如果参数是文件路径，用 Glob 或 Read 工具确认文件存在于当前目录 - 如果参数为空，提示用户提供 Markdown 文件路径或文本

1. 检查本地安装：执行前先确认 md2png-cli@1.0.2 已在本地安装：

   npx --no-install md2png-cli --version

- 若命令失败（退出码非 0），停止执行，提示用户先运行以下命令安装后再重试：

     npm install -g md2png-cli@1.0.2

- 不得跳过此检查自动联网下载

1. 执行转换：确认本地已安装后，使用 --no-install 标志执行，防止运行时触发网络下载：

   npx --no-install md2png-cli <输入文件路径> -t <主题> -s <尺寸> -o <输出文件名>

- 如果输入是文件路径，直接传入（已通过校验的相对路径） - 如果输入是文本内容，禁止将原始文本直接拼接进 Bash 命令（防止 Shell 注入）。必须先用 Write 工具将文本写入当前目录下的临时文件（如 _md2png_tmp.md），再将该文件路径传给命令；转换完成后用 Bash 删除该临时文件

1. 展示结果：

- 告知用户图片已生成及保存路径 - 用 Read 工具读取生成的 PNG 图片，展示给用户预览

可用主题

可用尺寸

示例

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