自动化
给 Dify 加一个 Markdown 转图片工具
导入一份 OpenAPI schema,你的 Dify Agent 和工作流就能自行把 Markdown 渲染成图片——不用写代码节点,也不用自己托管服务。
用途
大家用它来做什么
01
让 Agent 直接把自己的 Markdown 回答变成可分享的卡片,中间不需要额外的人工步骤。
02
在工作流里把检索到的文档渲染成图片,产出报告式或幻灯片式的结果。
03
让知识库机器人用图片返回排版好的表格和图表,而不是丢出一堆原始 Markdown。
接入
接入 Dify
- 01
在「个人中心 → API tokens」创建令牌。它以 mti_ 开头,且只显示一次。
- 02
在 Dify 中打开「工具 → 自定义 → 创建自定义工具」。
- 03
在 schema 字段切换到「从 URL 导入」,填入这个地址。Dify 会自行拉取 OpenAPI 文档并列出 generate_image。
https://markdowntoimage.com/api/v1/openapi.json
- 04
认证方式选 API Key,类型选 Bearer,值填你的 mti_ 令牌。
- 05
保存后,generate_image 就会出现在该工作空间的所有 Agent、Chatflow 和工作流节点中。
主题、字体、代码样式、PDF 页面尺寸等全部参数,都列在 API 文档.
常见问题
技术支持Q1
为什么不能直接导入 /api/v1/schema 这个地址?
那个接口返回的是精简的工具描述,不是 OpenAPI 文档,而 Dify 的导入器要求 OpenAPI 3.x。请改用 /api/v1/openapi.json——同一个接口,只是换成了 Dify 能解析的格式。
Q2
Dify 的哪些功能能用这个工具?
凡是能调用自定义工具的地方都可以:Agent、Chatflow,以及工作流里的工具节点。保存后它会出现在整个工作空间的工具选择列表里。
Q3
能让 Agent 自己决定输出格式吗?
可以。schema 把 format 声明为 png、jpeg、webp、pdf 的枚举,模型可以根据用户诉求自行选择。不传则默认 png。
Q4
生成的文件存在哪里?
接口返回的是托管链接。如果你需要把文件存到自己的空间,可以在工作流的下一步下载它,或者把 mode 设为 binary 直接拿到字节流,自行写入任意位置。