Schema Documentation

DbSchema can generate interactive documentation in HTML5 and PDF format. We recommend first creating multiple layouts, each focused on a specific part of the schema.

Generate the Documentation

  1. Go to Layout > Export HTML5 or PDF Documentation;
  2. Choose the format: HTML5 or PDF;
  3. Choose the layouts to include:
    • Current
    • Open
    • Selected
    • All having tag 'documentation' - In the Layout Properties dialog, near comments you can configure tags. The layouts will be sorted in the documentation based on the 'documentation' tag value.
  4. Choose documentation content;
  5. You preview the documentation in your browser.
Generate database documentation dialog

Add Comments in the Diagram

When creating tables or columns, you can add comments about their contents in the Description section. Read these comments in the HTML5 Documentation if you hover over the table or column.
Add table and column comments to schema
Beside text comments, DbSchema can store comment tags, as pairs of (key-value). The comment tags will be available in the generated documentation and can be used in Automation Scripts.
DbSchema comment tags

Explore the Documentation

Open the HTML5 documentation using any browser. Read the tables and columns comments as mouse-over tooltips.
Read table and column comments in the HTML5 documentation as mouse-over tooltips.

Programmatically Generate Documentation

Documentation can be generated using Groovy Scripts. Read further details in the Documentation.