Mermaid

Mermaid é uma linguagem de diagramação baseada em texto, integrada ao Markdown. Em vez de usar ferramentas visuais, você escreve o diagrama como código, o que facilita versionamento, edição e manutenção.

O Obsidian suporta Mermaid nativamente: basta usar o bloco de código com a linguagem mermaid.

Flowchart

O tipo mais versátil. Serve para pipelines, arquiteturas e fluxos de decisão.

flowchart LR
    A[Fonte] --> B[Bronze]
    B --> C[Silver]
    C --> D[Gold]
    D --> E[BI / ML]

Direções disponíveis: LR (esquerda→direita), TD (cima→baixo), RL, BT.

Formas de nó:

• [texto]: retângulo
• (texto): arredondado
• {texto}: losango (decisão)
• ((texto)): círculo
• [(texto)]: cilindro (banco de dados)

flowchart TD
    A([Início]) --> B{Dado válido?}
    B -- Sim --> C[Processar]
    B -- Não --> D[Mover para quarentena]
    C --> E[(Delta Lake)]

Sequence Diagram

Bom para representar interações entre sistemas ou serviços ao longo do tempo.

sequenceDiagram
    participant API
    participant Kafka
    participant Spark
    participant Lake

    API->>Kafka: Publica evento
    Kafka->>Spark: Consome mensagem
    Spark->>Lake: Escreve na Bronze

Entity Relationship Diagram

Para modelagem de dados: tabelas e seus relacionamentos.

erDiagram
    CLIENTE {
        int cliente_id PK
        string nome
        string email
    }
    PEDIDO {
        int pedido_id PK
        int cliente_id FK
        date data_pedido
        decimal valor_total
    }
    CLIENTE ||--o{ PEDIDO : "realiza"

Git Graph

Útil para documentar estratégias de branching em projetos com CI/CD.

gitGraph
    commit id: "init"
    branch dev
    checkout dev
    commit id: "feature A"
    commit id: "feature B"
    checkout main
    merge dev id: "release v1"

Timeline

Para representar evoluções históricas ou roadmaps.

timeline
    title Evolução do ecossistema de dados
    Anos 90  : Data Warehouse
    2010     : Hadoop / HDFS
    2014     : Apache Spark
    2018     : Cloud-native
    2020     : Lakehouse

Pie Chart

Para proporções simples.

pie title Distribuição de tipos de banco
    "Relacional" : 40
    "NoSQL" : 30
    "Data Warehouse" : 20
    "Grafo" : 10

Referência rápida

Tipo	Palavra-chave	Melhor para
Fluxo	flowchart	Pipelines, arquiteturas, decisões
Sequência	sequenceDiagram	Interações entre serviços
Entidade	erDiagram	Modelagem de dados
Git	gitGraph	Estratégias de branching
Timeline	timeline	Histórico, roadmap
Pizza	pie	Proporções simples