Mermaid Design

Primeiros passos

mermaid.design é um editor de diagramas Mermaid online. Escreva a sintaxe Mermaid à esquerda e veja o diagrama renderizado em tempo real à direita. Tudo é executado inteiramente no seu navegador — os seus diagramas nunca saem do seu dispositivo.

O seu primeiro diagrama

  1. Abra mermaid.design — o editor carrega com um fluxograma de exemplo.
  2. Edite o código Mermaid no painel esquerdo, por exemplo:
flowchart TD
    A[Início] --> B{Pronto?}
    B -- Sim --> C[Publicar]
    B -- Não --> D[Continuar a programar]
  1. A pré-visualização é renderizada novamente automaticamente à medida que escreve (com um pequeno debounce). Se a sintaxe for inválida, o último diagrama válido permanece visível atrás de um aviso de erro, e o editor de código assinala a linha com problemas.

A bancada de trabalho

O editor é uma bancada de trabalho com três painéis:

  • Editor de código (esquerda) — um editor CodeMirror leve com realce de sintaxe Mermaid, marcadores de erro inline, seleção sincronizada com o canvas e uma barra de ferramentas para formatar/copiar/limpar. Pode recolhê-lo numa faixa fina de ícones ou arrastar o divisor para redimensioná-lo.
  • Pré-visualização (centro) — o canvas interativo do diagrama. Arraste o espaço vazio para mover, use Ctrl/⌘ + rolagem ou pinça para zoom e o botão de ajuste à visualização. O fundo pode ser pontos / branco / xadrez.
  • Painel de tema (direita) — predefinições com um clique, variáveis de tema detalhadas e geração de temas a partir de uma cor-base. Ver abaixo.

Em ecrãs estreitos, a bancada torna-se um painel único com uma barra de separadores inferior Código / Pré-visualização / Tema.

Edição visual e ferramentas de código

  • Editar no canvas — faça duplo clique num nó ou rótulo para editar o texto e prima Enter ou clique fora para confirmar. Clique numa entidade para abrir o seu painel de edição; conforme o tipo de diagrama, pode alterar formas, cores, conexões e outras propriedades, ou eliminá-la.
  • Seleção sincronizada — selecionar uma entidade no canvas destaca e revela o seu código Mermaid. Mover o cursor do CodeMirror sobre o código de uma entidade também a seleciona no canvas.
  • Histórico partilhado — Ctrl/⌘+Z e Ctrl/⌘+Shift+Z anulam e refazem alterações de código e do canvas num único histórico.
  • Localizar e substituir — prima Ctrl/⌘+F para localizar e Ctrl/⌘+H para abrir a substituição. Use anterior/seguinte, diferenciação de maiúsculas, expressões regulares, palavras inteiras e substituição única ou total; o canvas também é atualizado.

Modos de renderização

Use o controlo segmentado na barra de navegação para mudar a forma como o diagrama é renderizado:

  • Oficial — a saída SVG padrão do Mermaid, exatamente como o motor Mermaid a renderiza.
  • ASCII — o seu diagrama convertido em arte de texto que pode colar em comentários de código, documentação ou terminais. Veja Renderização ASCII.

O modo faz parte do URL, pelo que pode guardar nos favoritos ou partilhar uma ligação para um modo específico.

Temas

Cada diagrama é renderizado com o tema base mais um conjunto de mais de 70 variáveis de tema editáveis:

  • Predefinições — os 11 temas incorporados do Mermaid (Default, Neutral, Forest, Dark, Base e mais) além de predefinições de designer, cada uma com uma mini pré-visualização.
  • Variáveis do tema — ajuste cores, bordas e tipos de letra individuais por grupo, com pesquisa.
  • Gerar — derive um tema completo a partir de uma única cor-base, claro ou escuro.

O seu trabalho é guardado automaticamente

O editor guarda o seu código, tema e layout no armazenamento local do navegador. Feche o separador e volte mais tarde — o seu diagrama continua lá. Nada é enviado para um servidor.

Próximos passos