Skip to main content

Export and print

Every diagram — in the editor and in your docs — exports what it shows: the current view, the detail level, the colour mode and colours, tables you dragged where you left them, and any search, path or diff tones that are on screen.

SVG and PNG​

The toolbar's Export menu (the download icon) has:

  • Download SVG — a standalone vector file with its styles embedded, for slides, wikis and design tools. Text stays text: it is searchable and sharp at any size.
  • Download PNG — a bitmap at twice the screen resolution, for chats and issue trackers.

The file is named after the diagram's title (Shop → shop.svg).

PDF​

Export ▸ PDF… opens the PDF dialog. The PDF is vector (text stays text) and is built in your browser; the library loads only when you open the dialog.

Pages

  • Tiled — the diagram at print scale, across as many pages as it needs. Each page overlaps its neighbours (10 mm by default, up to 30 mm) and carries cut marks, its tile name (B2, with the names of its neighbours at the edges) and its page number; an overview page comes first, with the grid's row letters and column numbers in its margins, so a large schema becomes a poster you can tape together. Pages that would hold nothing but stray relationship lines are left out (Skip empty pages, on by default): they keep their place in the grid, so B2 is still row B, column 2, and the overview crosses them out. The dialog shows the page count as you change the options ("24 pages (6 × 5, 6 empty left out)").
  • One page per view — every view you tick, scaled to fit its own page: a handout with one page per area of the schema. A view with no tables or notes is left out, and the page count says so ("5 pages, one per view, 1 empty view left out").

Options: paper A4 or Letter, orientation Automatic, Portrait or Landscape, Scale from 50 to 200 % (tiled), overlap, cut marks and page labels, overview page, skip empty pages.

A page whose diagram text uses characters the standard PDF fonts lack (Greek, Cyrillic, CJK, emoji) is embedded as a high-resolution image instead (each tile rendered on its own at three times the print size): it prints correctly, but its text cannot be selected.

Print​

The toolbar's Print button prints just the diagram, scaled to fit a landscape page, in light colours. Printing the whole docs page (Ctrl/Cmd+P) prints every diagram on it as the sharp, static SVG described below, one per box.

Static SVG in your docs​

The Docusaurus plugin draws every diagram into the page's HTML when the site is built. That picture:

  • shows without JavaScript, before the interactive viewer has loaded, and to search engines and link previews, which see every table and column name;
  • is what printing a page uses;
  • follows the site's light and dark theme without JavaScript (its colours are CSS variables);
  • is replaced in place by the interactive viewer, with the same table positions, so nothing jumps.

To get the SVG file of a docs diagram, use Export ▸ Download SVG; the static picture in the HTML is styled by the site's CSS and is not meant to be copied out on its own.

In the editor​

The editor's Export menu has the same SVG, PNG and PDF exports for the diagram (the PDF dialog can export every view of the file at once), plus the DBML file, the layout JSON and SQL for PostgreSQL, MySQL, SQL Server, Oracle and Snowflake. See the editor.