Skip to content

User guide

This guide covers everyday use of DiagramaHub: creating diagrams as code or freehand, organizing them into projects and folders, exporting and sharing them, and using AI with your own key (BYOL).

If you are installing or running your own instance, see the Self-host section.

  • Getting started

    Create your account, your first project and your first diagram, and learn the interface.

    Get started

  • The editor

    Code, live preview, autosave, explorer, description and appearance.

    Learn the editor

  • Diagram types

    Mermaid, PlantUML, D2 and DBML: examples, themes and options for each.

    See the types

  • Freehand whiteboard

    Draw hand-drawn shapes and arrows and turn them into Mermaid.

    Use the whiteboard

  • Projects and folders

    Organize, move, duplicate and search your diagrams.

    Organize

  • Export and import

    PNG, SVG, PDF, Markdown, project ZIPs and Excalidraw files.

    Export and import

  • Sharing diagrams

    Public or access-code protected links with expiration.

    Share

  • Presentation mode

    Show your diagram full-window, without distractions.

    Present

  • AI assistant

    Generate, improve, fix and convert diagrams with your own AI provider.

    Use AI

  • Your account and security

    Profile, password, two-step verification (MFA) and account deletion.

    Your account

A typical journey

flowchart LR
    A[Create account] --> B[Create project]
    B --> C[Create diagram]
    C --> D{How?}
    D -->|Code| E[Editor<br/>Mermaid · PlantUML · D2 · DBML]
    D -->|Drawing| F[Freehand whiteboard]
    D -->|AI| G[AI Chat]
    E --> H[Export · Share · Present]
    F --> H
    G --> E

Language and theme

The interface is available in Spanish and English. Change the language and switch between light and dark mode from the sidebar; both preferences are remembered in your browser.