🧠 Mermaid

Mapa mental

Organize ideias em torno de um tema central

O que é um Mapa mental?

Um mapa mental faz irradiar ramos de ideias a partir de um conceito central. É a forma mais rápida de estruturar brainstormings, decompor temas, planear conteúdos ou mapear competências — e com o Mermaid é texto puro.

O mapa mental é mais uma ferramenta de pensamento do que de documentação: workshops, planos de conteúdos, delimitação de uma funcionalidade antes de alguém se comprometer. No Mermaid, a indentação serve ao mesmo tempo de estrutura do documento, pelo que o mapa e o futuro índice ficam num só artefacto. A restrição a aceitar é que se trata de uma árvore: uma raiz, um pai por nó, sem rótulos nos ramos. Tudo o que tenha de convergir pertence a um fluxograma.

Exemplo em tempo real

Código Mermaid
mindmap
  root((Product v2))
    Features
      AI generation
      Live preview
      Export
    Quality
      E2E tests
      Monitoring
    Growth
      SEO pages
      Public sharing
Exemplo em tempo real

Product v2

Features

AI generation

Live preview

Export

Quality

E2E tests

Monitoring

Growth

SEO pages

Public sharing

Quando usar

Estruturar brainstormings e resultados de workshops
Decompor um produto, um projeto ou um tema de aprendizagem
Planear conteúdos, documentação ou competências da equipa

Erros frequentes

Duas raízes no nível de topo

Um mapa mental tem exatamente uma raiz. Um segundo nó com a mesma indentação falha com «There can be only one root». Se tem mesmo dois centros, então são dois mapas mentais — ou um fluxograma.

Parênteses dentro do texto de um nó

Growth (EU) é renderizado como «EU», porque os parênteses são lidos como delimitador de forma redonda e o texto anterior é descartado. Dê um id ao nó e ponha o rótulo entre aspas: g1["Growth (EU)"].

Tabulações misturadas com espaços

A hierarquia vem apenas da indentação, e uma tabulação não equivale a espaços. Misturá-las provoca o mesmo erro «There can be only one root», que aponta para a raiz e não para a linha que estragou.

Sintaxe básica

.mmd
mindmap
  root((Main idea))
    Branch A
      Leaf 1
    Branch B
  • mindmap root((Product v2))

    Existe exatamente uma raiz, e os parênteses duplos desenham-na como um círculo. Tudo o que está por baixo é posicionado apenas pela indentação, sem setas para declarar.

  • Features[Squared] Live preview(Rounded)

    Os delimitadores à volta do texto escolhem a forma do nó: [] quadrado, () redondo, (()) círculo, ))(( explosão, {{}} hexágono. Use-os com parcimónia, para marcar uma categoria e não para decorar.

  • Growth ::icon(fa fa-rocket)

    Uma linha ::icon() sob um nó acrescenta um ícone de um tipo de letra de ícones carregado pela página anfitriã, normalmente o Font Awesome. Sem esse tipo de letra, não é desenhado nada.

  • Retention:::urgent

    Um triplo dois-pontos associa uma classe CSS a um nó, e é assim que se realça um ramo — riscos, bloqueios, decisões — sem tocar no resto do mapa.

Perguntas sobre este diagrama

Como funciona a indentação nos mapas mentais do Mermaid?

A hierarquia é definida unicamente pela indentação: cada nível mais profundo torna-se um ramo filho. Formas como root((texto)) personalizam a aparência dos nós.

Mapa mental ou fluxograma para um brainstorming?

Mapas mentais para divergir (recolher e agrupar ideias), fluxogramas para convergir (transformar as ideias num processo ordenado).

Posso partilhar um mapa mental com quem não usa Mermaid?

Exporte em PNG ou SVG, ou publique o diagrama como página pública e partilhe a ligação. O GitHub também renderiza mapas mentais em Markdown, embora ferramentas auto-alojadas com um Mermaid antigo possam ainda não conhecer a sintaxe.

Posso escolher de que lado aparece um ramo?

Não. A colocação é calculada a partir da árvore e não há definição de esquerda, direita ou ângulo. Reordenar os ramos no código muda o resultado, mas não de forma previsível — aceite a disposição, ou passe para um fluxograma.

Como acrescento ícones aos nós de um mapa mental?

Acrescente uma linha ::icon(fa fa-book) indentada sob o nó. O tipo de letra de ícones tem de ser carregado pela página que renderiza o diagrama; quando falta, o nó aparece simplesmente sem ícone e nada se parte.

Posso transformar um mapa mental num índice de documento?

Diretamente — a indentação já é o índice. Cada nível do mapa passa a nível de título ou a lista aninhada, e é por isso que os mapas mentais funcionam bem para planear documentação antes de escrever fosse o que for.

Mapa mental ou outro tipo de diagrama?

Mapa mental ou linha do tempo?

Olhe para o primeiro nível. Se os ramos de topo são T1, T2, T3 — ou 2024, 2025 — está a desenhar uma linha do tempo com indentação a mais, e a árvore não acrescenta nada. Fique com o mapa mental quando o nível de topo são temas e é o aninhamento que transporta o sentido.

Mapa mental ou diagrama de classes?

Um mapa mental exprime uma única relação: isto está debaixo daquilo. Não consegue dizer que um módulo depende de outro, que possui três deles ou que implementa uma interface. Assim que as caixas precisam de campos, de cardinalidades ou de um sentido de dependência, use um diagrama de classes.

Crie já o seu Mapa mental

Descreva-o em linguagem natural — a IA escreve o código Mermaid por si.

Abrir o Mermaid Studio