excalidraw-renderer
将Excalidraw JSON文件渲染为PNG图片的Python CLI工具。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:excalidraw-renderer。 它的用途是:将Excalidraw JSON文件渲染为PNG图片的Python CLI工具。 完整的 Skill 内容见:https://321skill.com/skills/excalidraw-renderer/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我画一个展示微服务架构的流程图',它会生成对应的Excalidraw JSON代码,并自动调用此工具将其渲染为清晰的PNG图片,方便你插入文档。或者,当你已经有一个.excalidraw文件时,可以直接在终端运行命令进行批量转换,快速准备汇报材料。
介绍
excalidraw-renderer 解决了AI生成图表后无法直接导出为高质量图片的问题。它是一个命令行工具,可以读取标准的Excalidraw JSON文件(.excalidraw格式),并将其准确地渲染为PNG图像,特别优化了对文本的渲染支持,避免了字体显示异常。
使用非常简单,只需在终端中执行命令 excalidraw-render input.excalidraw -o output.png 即可完成转换。它也支持批量渲染,可以一次性处理多个文件。对于Claude用户,可以通过安装Skill的方式,在对话中直接调用 /excalidraw-diagram 命令来生成和渲染图表。
这个工具非常适合需要将技术架构图、流程图等Excalidraw图表嵌入到文档、演示文稿或网页中的开发者、技术写作者和产品经理。它确保了图表在不同平台和媒介上都能保持一致的视觉效果。
使用建议:在创建Excalidraw JSON时,为了获得最佳的渲染效果,建议为技术图表设置 fontFamily: 5(等宽字体)和 roughness: 0(平滑线条)。虽然支持容器内文本,但使用独立的文本元素仍然是更稳妥的选择。注意,不支持的图形类型会明确报错,而不是被静默忽略。
核心特点
与仅能截图或导出SVG的在线工具不同,此工具通过命令行提供精准的PNG渲染,尤其解决了AI生成图表时文本字体渲染的痛点;同时,它深度集成了Claude Code,能作为Skill被AI直接调用,实现从JSON生成到图片输出的自动化工作流。
注意事项
不适合需要实时协作编辑或直接在浏览器中交互式修改图表的场景。
常见问题
如何将AI生成的Excalidraw JSON变成图片?
将JSON保存为.excalidraw文件,然后使用命令 `excalidraw-render 文件名.excalidraw -o 输出.png` 即可。
在Claude里怎么用这个工具画图?
安装对应的Claude Skill后,对AI说“/excalidraw-diagram”并描述你的图表,AI会生成JSON并自动调用此工具渲染为图片。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/excalidraw-renderer/raw/index.md 读取 excalidraw-renderer 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/excalidraw-renderer/raw/index.md(查看排版版本)