ditaa

Convert ASCII art to PNG image

$ ditaa [input.txt] [output.png]

$ ditaa -A [input.txt] [output.png]

$ ditaa -S [input.txt] [output.png]

$ ditaa -r [input.txt] [output.png]

$ ditaa -s [2.0] [input.txt] [output.png]

$ ditaa --svg [input.txt] [output.svg]

$ ditaa -T [input.txt] [output.png]

ditaa [options] input [output]

ditaa (DIagrams Through ASCII Art) converts ASCII art diagrams into proper graphics. It recognizes boxes, lines, and basic shapes drawn with ASCII characters and renders them as bitmap or vector images.
Input uses standard ASCII characters: +, -, | for box corners and edges, / and \\ for diagonals, = for dashed lines, and text inside boxes for labels. Color tags like {c:red} customize appearance.
The tool is useful for documentation, where diagrams can be kept as ASCII in source files (version-controllable, editable) and rendered to images for publication.

-A, --no-antialias

Disable antialiasing.

Disable drop shadows.

Use rounded corners for boxes.

Scale output by factor.

Use transparent background.

Disable shape edge separation.

Input file encoding.

Output as SVG instead of PNG.

Tab size for input.

Verbose output.

Requires Java Runtime Environment. Complex diagrams may not render as expected. Limited to shapes that can be represented in ASCII. Some Unicode box-drawing characters are not recognized by default.

ditaa was created by Stathis Sideris in 2004 as an open-source Java application. The concept was inspired by the desire to keep diagrams as plain text in source code repositories while having nice rendered versions for documentation. The tool has been integrated into various documentation systems including Asciidoctor and Org-mode.

graphviz(1), plantuml(1), asciiflow(1), mermaid(1)