2 min read

D2 0.7.1 升级:ASCII 输出赋能代码文档,可视化沟通新维度

D2 的最新版本 0.7.1 引入了 ASCII 输出功能,旨在提升代码文档的可读性与便携性。用户可以将 .d2 文件输出为 .txt 格式,自动启用 ASCII 渲染器。此功能尤其适用于在源代码注释中嵌入流程图,以直观方式展示函数或类的逻辑关系,比纯文本描述更为清晰。通过 Vim 扩展等工具,可实现代码与 ASCII 图形的快速转换。

该渲染器默认使用 Unicode 字符集以获得更优的盒状字符效果,但可通过 `--ascii-mode=standard` 标志切换至纯标准 ASCII 以实现最大程度的兼容性。目前此功能仍处于 Alpha 阶段,存在不少待完善之处,建议用户通过 GitHub 报告遇到的问题。ASCII 渲染是基于 ELK 布局引擎的缩小版,并进行了后处理以进一步压缩。动画和字体等样式功能不适用于 ASCII 环境,颜色样式未来可能在终端渲染中有限支持。此外,Markdown、Latex、代码、图片、图标、UML 类图、SQL 表格以及部分形状(如圆形、云形)因其复杂性或曲线特性,在 ASCII 环境下无法完美呈现,目前会以矩形加左上角图标的方式替代,建议暂时避免使用自定义形状。

ASCII output | D2 Documentation
In the latest release of D2 (0.7.1), we introduce ASCII outputs.
订阅情报