
D2 导出 6 种格式的完整指南命令、参数与常见误区【免费下载链接】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、ASCII 文本共 6 种导出格式各有适用场景而且每种格式的行为规则并不一样。选错格式轻则重新渲染重则功能直接丢失。本文按先避坑再选格式的顺序展开所有命令都基于 CLI 实测行为参数说明可在 d2cli/main.go 中对照源码验证。6 种导出格式怎么选看输出文件后缀D2 用输出文件名的后缀判断导出格式不需要额外的格式参数d2 input.d2 out.svg # 后缀是 .svg就导出 SVG d2 input.d2 out.png # 后缀是 .png就导出 PNG注意两点无后缀或非支持的后缀会默认导出为 SVG输出多个文件时每个文件各自按后缀处理一次命令可以同时产出多种格式。后缀格式适用场景.svg矢量图网页、技术文档支持暗色主题、链接、tooltip、动画.png位图社媒分享、贴到其他工具里.pdf矢量文档打印、正式报告.pptx演示文稿周报、评审会.gif动图多 board 的动画序列.txtASCII 图终端输出、纯文本评审--dark-theme 只对 SVG 生效这是最常踩的坑暗色主题参数只作用于 SVG 输出导出 PNG 或 PDF 时它完全无效。要出明暗两套图有两条路导出两次d2 input.d2 light.svg和d2 input.d2 --dark-theme 2 dark.svg分别指定明暗主题 ID在图表代码里直接写死深色系的style.fill/style.font-color但注意显式样式会覆盖主题暗色模式下可能出现非预期颜色。另外SVG 输出默认会把外部资源打包进单文件--bundle默认开启。如果你的图标是远程 URL导出的 SVG 会自包含分发时不用担心图片丢失。PNG、PDF、PPTX 共用同一渲染管线这三者都走 D2 内置的位图渲染管线带来两个连带影响位图无法交互。图表里的链接和 tooltip 在 PNG 里点不了所以 PNG 导出会自动在底部追加一个 appendix 区域把链接和 tooltip 以文字形式补上。想让 SVG 也带上这个区域加--force-appendix。字体依赖 D2 二进制。想换字体用--font-regular、--font-bold等参数传入.ttf文件路径默认字体是 Source Sans Pro 和 Source Code Pro。控制尺寸用--scale如--scale 0.5减半和--pad周边留白像素数。还有一个实用参数--no-xml-tag去掉 SVG 头部的 XML 声明把 SVG 直接内嵌进 HTML 页面时必须加它。D2 导出的演示文稿效果图导出动画必须有多 board且仅限 SVG 和 GIF动画导出的前提是你的文件里有多个 boardlayers、scenarios 或 steps单张静态图无法动画。d2 input.d2 out.gif --animate-interval 1500规则有三条只有SVG 和 GIF支持动画其他格式加了参数也没用--animate-interval单位是毫秒指定多个 board 会打包成一张逐个切换的图GIF 导出若不指定间隔默认 1000msSVG 动画则不会自动启用。把导出接进脚本stdout 与常用输出参数D2 支持把结果写到标准输出方便管道和 CId2 input.d2 --stdout-format png - out.png--stdout-format支持svg、png、pdf、pptx、gif、ascii、txt七种写法ascii和txt等价。几个值得记住的输出参数--timeout大文件渲染超时控制默认 120 秒图很大时调大--center把 SVG 居中到 viewBox适合直接嵌网页--target只渲染文件中的指定 board如--target layers.a.*。场景决策速查表按你的最终用途对号入座你的场景推荐格式关键参数网页 / 技术文档SVG--no-xml-tag内嵌 HTML 时深浅双主题页面SVG--dark-theme导出第二份周报、评审 PPTPPTX图表元素可直接再编辑打印、存档PDF--scale控制尺寸社媒、聊天分享PNG留意底部自动 appendix多 board 演示动效GIF--animate-interval毫秒终端、纯文本评审TXT--ascii-mode standard纯 ASCII 字符三个高频注意点导出前过一遍先查后缀没写对后缀D2 会悄悄给你 SVG暗色主题只在 SVG 上生效位图格式请改在代码里控制颜色位图自带 appendixPNG 底部的链接文字区不是 bug是交互功能的补偿。【免费下载链接】d2D2 is a modern diagram scripting language that turns text to diagrams.项目地址: https://gitcode.com/GitHub_Trending/d2/d2创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考