Mermaid Design

Renderização ASCII

O modo ASCII transforma o seu diagrama Mermaid em arte de texto — perfeito para comentários de código, ficheiros README, descrições de pull requests, saída de terminal, ou qualquer lugar onde uma imagem não pode ir.

Mudar para o modo ASCII

Clique em ASCII no seletor de modo da barra de navegação (ou abra /ascii diretamente). O mesmo código Mermaid no editor é renderizado como caracteres em vez de um SVG:

┌───────┐      ┌────────┐
│ Start │─────▶│ Ship it│
└───────┘      └────────┘

A renderização ASCII é fornecida por beautiful-mermaid, um port em TypeScript do mermaid-ascii. O renderizador é carregado sob demanda, pelo que só é descarregado quando abre o modo ASCII pela primeira vez.

Definições

Com o modo ASCII ativo, o painel direito mostra as definições ASCII:

  • Conjunto de caracteres — Unicode ─│┌ usa caracteres de desenho de caixas para linhas e cantos suaves; ASCII - | + restringe a saída a caracteres ASCII simples para máxima compatibilidade (terminais antigos, ferramentas de revisão de código, e-mail em texto simples).
  • Tamanho da Fonte — dimensiona o texto renderizado, útil para encaixar um diagrama grande num bloco de comentário estreito.

Tipos de diagramas suportados

Fluxogramas e diagramas de sequência são os que renderizam melhor. Alguns tipos de diagramas Mermaid ainda não são suportados pelo renderizador ASCII — para esses, a pré-visualização mostra uma mensagem alternativa localizada em vez de um resultado quebrado.

Ligações muito longas (---->) são normalizadas automaticamente antes da renderização, pelo que diagramas com arestas esticadas continuam a produzir resultados sensatos.

Exportação

No modo ASCII, a caixa de diálogo de exportação oferece TXT (texto simples) — o diagrama de texto renderizado, pronto para colar em qualquer lugar. Veja Exportar e partilhar.

Explorar modelos ASCII

Abra /ascii/templates para explorar a galeria de modelos renderizada como arte ASCII. Os modelos não suportados são filtrados automaticamente, e os filtros por tipo ajudam a encontrar um ponto de partida. Veja Modelos.