D2图表导出实战笔记一个脚本转出SVG、PNG、PDF三种格式【免费下载链接】d2D2 is a modern diagram scripting language that turns text to diagrams.项目地址: https://gitcode.com/GitHub_Trending/d2/d2D2 是一款把文本转成图表的现代脚本语言用.d2文件描述节点与连线一条命令就能渲染出 SVG、PNG、PDF、PPTX 甚至 GIF。导出这件事看着简单但选错格式、漏掉参数图放到网页或文档里就露馅。下面按同一张图要去不同地方的思路把导出时的关键选择讲清楚。文件扩展名决定导出格式不带输出路径时d2 input.d2会默认生成input.svg——SVG 就是默认格式。实际导出时第二个参数的扩展名就是格式本身.svg出矢量图.png出位图.pdf出矢量文档.pptx出幻灯片页.gif出动画.txt出终端里的 ASCII 图。不用额外指定导出类型改个文件名就行。SVG 导出时值得留意的参数SVG 可以无损缩放放进网页最稳所以大多数场景优先选它。围绕 SVG 有三个参数最常用--pad控制图表四周留白单位是像素图边缘文字被裁掉时先调它--dark-theme给指定一个主题 ID当查看者浏览器处于深色模式时自动切换配色注意它只对 SVG 生效--scale缩放输出比如 0.5 就是一半大小SVG 默认会自动适配屏幕设成 1 可关掉这个自适应行为。主题编号可以跑d2 themes直接列出所有可选 ID。网页截图、社媒配图要 PNG 时PNG 是光栅化位图适合直接贴进文档、发到社交平台。它对分辨率敏感想更清晰就靠--scale往上调比如 2 就是两倍尺寸输出。非 SVG 格式默认使用各自的默认渲染尺寸所以图糊了基本从缩放系数找原因而不是渲染器配置。PDF、PPTX 及其他格式正式文档和打印选 PDF它保留矢量信息放大不糊。图表要进演示文稿时直接输出.pptx得到一个幻灯片页省去导出图片再插图的中间环节。终端用户可以直接要.txtD2 会把图渲染成 ASCII 形式。一次转出多种格式的脚本同一张图经常要同时交付三种格式写个小脚本最省事d2 diagram.d2 diagram.svg d2 diagram.d2 diagram.png d2 diagram.d2 diagram.pdf三条命令共享同一份.d2源文件改了图重跑一遍即可各格式输出互不影响。多 Board 导出成动画 GIF如果.d2文件里写了多个 Board加上--animate-interval单位毫秒后D2 会把它们打包进一个会逐页切换的 SVG或者直接导出 GIF。这个参数只支持 SVG 和 GIF 两种输出导 GIF 时不指定间隔则默认 1000 毫秒。输出不对时从哪里查图放出来不符合预期按这个顺序排查PNG 偏小偏糊查--scale布局结构意外检查--layout或D2_LAYOUT环境变量是否切了引擎配色没随系统变暗确认用的是 SVG 输出且--dark-theme传的是合法主题 ID。装好工具后跑一下d2 --help所有参数说明都在里面配合 安装说明 足够覆盖日常导出需求。【免费下载链接】d2D2 is a modern diagram scripting language that turns text to diagrams.项目地址: https://gitcode.com/GitHub_Trending/d2/d2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考