Blog

Export your whole project as context for ChatGPT or Claude

Version 0.8.0 exports whole projects as AI-ready Markdown or ZIP, imports Excalidraw drawings and gives the whiteboard a hand-drawn look.

Your diagrams describe how your system works: authentication flows, the database schema, the sequence between services. That's exactly the context an AI assistant is missing when you ask about your architecture. Until now you had to copy them one by one. Since version 0.8.0 you export the whole project in one step.

Two formats, two uses

When you export a project (or a single folder) you choose between:

  • ZIP: one subfolder per project folder, one file per diagram with its language's extension (.mmd, .puml, .d2, .dbml, or .freehand.json for whiteboards), its description in a .md next to it, a README.md index and a manifest.json to import it again.
  • A single Markdown file, in two variants:
    • AI context: starts with a preamble that explains the file to the model, and includes an index with paths, each diagram's metadata and a token estimate. Ready to paste into ChatGPT or Claude.
    • Standard: a clean document for your wiki or repository.

Either way, diagrams go in code blocks tagged with their language (mermaid, plantuml, d2, dbml), so any Markdown-aware tool recognizes them.

What the flow looks like

flowchart LR
    A[Project in DiagramaHub] --> B{What do you need it for?}
    B -->|Give an AI context| C[AI-context Markdown]
    B -->|Documentation| D[Standard Markdown]
    B -->|Backup or migration| E[ZIP]
    C --> F[ChatGPT / Claude]
    D --> G[Wiki or README]
    E --> H[Import into another instance]

Before downloading, DiagramaHub shows what will be exported: number of diagrams and folders, size and, for the AI variant, the approximate tokens. You know whether it fits your model's context window before you paste it.

Where to find it

  • In the editor's explorer, with the download icon (whole project) or from a folder's menu → Export folder.
  • In the projects list.

And back in: import

The other half of the story is bringing diagrams in. From the explorer's upload icon, a folder's menu (Import here) or by dragging files from your computer onto the explorer, you can import:

  • Single .mmd, .puml, .d2, .dbml files, Markdown with a code block, and .freehand.json whiteboards.
  • ZIPs: DiagramaHub exports restore folders and colors; any other ZIP creates folders from its paths.
  • Excalidraw drawings (.excalidraw): shapes, labels, bound arrows, strokes and text become a whiteboard.

Before anything is created you get a preview with the folders and diagrams to be created, skipped files and why, and your plan's quota. Import is all or nothing: if something fails halfway, what was created is rolled back.

The whiteboard now looks hand-drawn

0.8.0 is also the biggest whiteboard update since it arrived:

  • Hand-drawn look for shapes, lines and arrows, with stroke styles (Clean, Architect, Artist, Cartoonist) and fills (solid, hachure, cross-hatch).
  • Smooth freehand strokes with variable width and pen pressure.
  • Handwriting font for new text, with a Handwritten / Regular / Code selector.
  • Lock elements (Ctrl/Cmd+Shift+L) so they can't be moved, resized or deleted by accident.
  • Export to PNG at 1x, 2x or 3x with an optional transparent background, and download the source as .freehand.json.
  • Sketch → Mermaid: shapes with text become nodes and bound arrows become edges of a new flowchart. No AI involved, so the result is exact and repeatable.

Existing drawings keep their clean look; only new elements use the hand-drawn style, switchable per element.

No lock-in

Your diagrams are text, and now they move in and out of DiagramaHub freely. Take a project to your repository, share it with someone on another instance, or give your AI the full map of your system.

Available now on DiagramaHub Cloud and in the self-hosted version. Technical details are in the changelog.