Use YAML as the editable handoff format. Use SVG, PNG or HTML to share the compiled drawing, TSV for the bill of materials, and DOT for further Graphviz work. The current editor has no project archive or persistent save function.
Import a harness
Open the File menu at the top left:
- Import YAML loads a
.ymlor.yamldefinition. - Import folder with images loads a YAML file and supported images from a folder, retaining paths relative to that YAML file where possible.
- Add images attaches images to the current source without replacing the YAML.
A YAML import replaces the source, imported image set and manual canvas positions. An images-only import merges attachments by name, replacing an existing attachment with the same name. Both are undoable in the current session.
If a folder contains several YAML files, the importer chooses the first one in the file list. Prepare a folder with one intended harness definition to avoid loading the wrong file. Native file and folder pickers are the supported file-import workflow; dragging from the Components library onto the canvas adds a library connector.
Match image paths
The image source in YAML must match an attached relative filename:
connectors:
X1:
pincount: 2
image:
src: images/connector.svg
width: 120
connections:
- [X1]
Keep images/connector.svg beside the YAML in that relative folder. A harmless ./ prefix is accepted. Absolute filesystem paths, parent-directory .. segments, URLs and backslash-separated paths are not supported.
Imported PNG, JPEG, GIF, WebP, BMP and SVG files are accepted within the resource limits. Raster images are converted to PNG for rendering; animations are not preserved. SVG needs positive dimensions or a viewBox. Common dimension units are supported. Safe presentation attributes, supported inline styles and local #id references are retained. CSS stylesheets must be converted to presentation attributes, and external images must be flattened before import. Unsupported content reports the image filename in Checks.
The compiler ignores an unreferenced malformed image. Import count and size limits still apply to the attached image collection. Remove unused attachments under Design → Images with nothing selected.
Bundled connector image paths load automatically from the site. Their reserved library names use the bundled artwork. Read connector artwork and credits before distributing those assets.
Available downloads
| Format | What it contains |
|---|---|
YAML .yml |
Current source, including incomplete or invalid edits. It does not embed custom images or manual canvas positions. |
SVG .svg |
The current WireViz schematic, with rendered images embedded and library attribution when applicable. |
PNG .png |
A rasterized copy of the SVG on white, normally at 2× size, capped at 8,192 pixels per dimension. |
HTML .html |
A standalone page with the document title, embedded schematic, BOM table and engine version. |
BOM .bom.tsv |
Current bill-of-materials column headings and rows for spreadsheet use. |
Graphviz .gv |
Diagram source with portable relative image references. Keep the original image files at those paths. |
SVG, PNG, HTML, TSV and DOT require a valid result for the current source and attachments. YAML can always be downloaded. Exports use the document title to create a filename.
HTML is a simple report, not WireViz's full native document-template output: it does not lay out DIN title blocks, authors or revision tables. Rich HTML in BOM descriptions is displayed as text rather than reproduced as rich formatting.
Preserve and share your work
Download the YAML and retain custom images in the same relative folder structure. To reopen it, import that folder. Manual canvas placement, panel preferences and undo history are not saved in these files. Official exports use WireViz's automatic diagram layout rather than the positions of the editor's draggable cards.
SVG and HTML include embedded rendered artwork. DOT does not bundle image files; the connector library provides an SVG pack + licenses download when its artwork is needed separately.
If an export is disabled, inspect Checks and wait for Up to date. See compilation troubleshooting.