Pular para o conteúdo principal

Guia rápido de gráficos de Gantt no Mermaid

Gantt mostra tarefas com datas, duração e dependências. Prefira uma linha do tempo para eventos narrativos ou um diagrama de sequência para mensagens entre sistemas.

Criar com o Criador de gráficos de Gantt →

Início rápido

Dê um id estável a cada tarefa e use after para iniciar após o término de outra.

Mermaid
gantt
  title Publicação da documentação
  dateFormat YYYY-MM-DD
  todayMarker off
  section Preparação
  Estrutura :done, outline, 2026-10-05, 2d
  Revisão :active, review, after outline, 3d
  Publicar :milestone, publish, after review, 0d

Carregando…

Referência de sintaxe

Referência de sintaxe
SintaxeSignificado
gantt / title / sectionInicia o diagrama, define o título e agrupa tarefas.
dateFormat YYYY-MM-DD / axisFormat %d %bdateFormat usa tokens do Day.js; axisFormat usa tokens do D3.
tickInterval 1week / weekday mondayDefine o intervalo e o primeiro dia das marcações semanais.
weekend friday / excludes weekends, 2026-10-12Configura o fim de semana; dias excluídos prolongam tarefas baseadas em duração.
includes 2026-10-10Uma data incluída prevalece sobre a exclusão; use datas, não nomes de dias.
inclusiveEndDatesInclui a data final informada explicitamente.
todayMarker off / todayMarker stroke:#0070f3,stroke-width:2pxOculta ou estiliza a linha da data atual.
Task :id, start, end / Task :id, start, 2dSepare o rótulo com dois-pontos e os metadados com vírgulas.
after a b / until c dafter aguarda o último término; until termina no primeiro início dos ids indicados.
500ms / 30s / 30m / 4h / 3d / 2w / 1M / 1yUnidades distinguem maiúsculas: m são minutos e M meses; aceitam decimais.
done / active / crit / milestone / vertTags vêm antes do id; milestone marca um instante e vert não ocupa uma linha.
click id href "https://example.com" / click id call callback()Links e callbacks dependem do ambiente; a segurança estrita desativa a interação.
topAxis / config.gantt.topAxis / config.gantt.displayMode: compactMostra o eixo superior e compartilha linhas entre tarefas sem sobreposição.
%% / accTitle: / accDescr:Comentários e descrições acessíveis.

Calendário de trabalho

Dias excluídos prolongam a duração sem dividir a barra. includes recupera datas específicas; datas finais explícitas mantêm seu limite, salvo inclusiveEndDates.

Mermaid
gantt
  dateFormat YYYY-MM-DD
  axisFormat %d %b
  tickInterval 1week
  weekday monday
  excludes weekends, 2026-10-12
  includes 2026-10-10
  todayMarker off
  section Redação
  Manual :handbook, 2026-10-09, 4d
  Correção :proof, after handbook, 2d

Carregando…

Dependências

Referencie ids, não rótulos. after com vários ids aguarda o último término; until encerra no primeiro início. Evite referências ausentes e ciclos.

Mermaid
gantt
  dateFormat YYYY-MM-DD
  todayMarker off
  section Publicação
  Validação final :milestone, signoff, 2026-10-15, 0d
  Edição :edit, 2026-10-05, until signoff
  Testes :test, 2026-10-07, 3d
  Pacote :package, after edit test, 1d

Carregando…

Status e marcadores

Combine crit com done ou active. Um marco sem duração fica no início; com duração, no ponto médio. vert atravessa o gráfico sem ocupar uma linha.

Mermaid
gantt
  dateFormat YYYY-MM-DD
  todayMarker off
  section Entrega
  Rascunho :done, draft, 2026-10-05, 2d
  Validar :crit, active, validate, after draft, 3d
  Prazo :vert, deadline, 2026-10-09, 0d
  Aprovação :milestone, approval, after validate, 0d

Carregando…

Links e segurança

click associa uma URL ou callback. Este site usa segurança estrita e desativa a interação no desenho; preserve essa proteção para código não confiável.

Mermaid
gantt
  dateFormat YYYY-MM-DD
  todayMarker off
  section Notas
  Ler guia :guide, 2026-10-05, 2d
  click guide href "https://themarkdowner.com"

Carregando…

Layout compacto e eixo superior

Coloque a configuração YAML antes de gantt. compact compartilha linhas quando possível, sem alocar recursos. A diretiva antiga %%{init: ...}%% também funciona.

Mermaid
---
config:
  gantt:
    displayMode: compact
    topAxis: true
---
gantt
  dateFormat YYYY-MM-DD
  todayMarker off
  section Tarefas
  Primeira rodada :first, 2026-10-05, 2d
  Segunda rodada :second, after first, 2d

Carregando…

Erros comuns

Misturar formatos de data

YYYY-MM-DD pertence a dateFormat e %d %b a axisFormat; alterar o eixo não muda a leitura de datas.

Inventar unidades

Uma unidade inválida pode virar duração zero sem aviso; confira o resultado.

Usar uma diretiva inexistente

dates não existe. Use dateFormat em sua própria linha.

Sintaxe inválida: veja a correção abaixo

gantt
  dates YYYY-MM-DD
Mermaid
gantt
  dateFormat YYYY-MM-DD
  todayMarker off
  section Verificação
  Verificar :check, 2026-10-05, 1d

Carregando…

Limitações

  • Mermaid não calcula caminho crítico nem controla a capacidade dos recursos.
  • Exclusões alteram durações, mas não deslocam automaticamente datas finais explícitas.
  • A segurança estrita desativa cliques nas tarefas.

Perguntas frequentes

Como excluir fins de semana?
Use excludes weekends; weekend friday seleciona sexta e sábado. includes recupera uma data específica.
Como ligar duas tarefas?
Defina um id para a primeira tarefa e use after com esse id na segunda; vários ids aguardam o último término.
Como imprimir este guia?
Imprima pelo navegador e selecione PDF; o código e os diagramas permanecem.