Como pré-visualizar texto Markdown em HTML

Quando usar esta pré-visualização

Esta ferramenta transforma texto não vazio com sintaxe semelhante a Markdown numa pré-visualização HTML formatada. Pode utilizá-la para verificar a organização visual de um apontamento, rascunho ou documento antes de reutilizar o conteúdo noutro contexto. A pré-visualização permite observar diferenças entre títulos, listas, ligações, citações e trechos de código sem ter de avaliar apenas o texto de origem.

O campo de texto é opcional, por isso também pode começar sem conteúdo. Essa opção é útil para confirmar o comportamento de uma entrada vazia antes de preparar um documento maior. Quando existe texto, a ferramenta trabalha com um conjunto definido de substituições baseadas em padrões semelhantes a Markdown, em vez de prometer a interpretação de toda a sintaxe possível.

Procedimento para testar um texto

1. Abra a ferramenta e localize a área destinada à introdução de texto.
2. Escreva ou cole o conteúdo que pretende analisar. Para uma verificação inicial, use uma amostra curta que contenha o elemento relevante, como # Agenda, uma lista com marcadores ou uma ligação.
3. Inicie a operação através do controlo disponível. O texto pode ser omitido ou deixado vazio; nessa situação, a operação termina com sucesso e o painel de pré-visualização fica sem conteúdo.
4. Leia o resultado formatado e compare-o com a entrada original. Confirme se a hierarquia dos títulos, a disposição das listas, a aparência das citações e a separação dos trechos de código correspondem ao que pretendia observar.
5. Teste outros padrões separadamente quando estiver a verificar uma estrutura mais complexa. A ferramenta inclui substituições para código delimitado e em linha, títulos dos níveis 1 a 6, linhas semelhantes a tabelas, separadores horizontais, citações, imagens, ligações, ênfase, texto riscado, listas e determinadas quebras de linha.
6. Se o resultado não coincidir com a expectativa, reduza a entrada ao trecho que causa a dúvida e volte a executar a operação. Compare então a forma escrita com os padrões tratados, sem presumir que uma construção não reconhecida representa um erro no documento inteiro.
7. Para uma entrada não vazia, consulte também a contagem de caracteres apresentada no resultado. Use esse valor como medida do texto original fornecido, e não como contagem de títulos, linhas ou elementos visíveis no painel.

O que o resultado permite concluir

Um resultado bem-sucedido para texto não vazio combina uma pré-visualização HTML formatada com a contagem de caracteres do conteúdo de origem. Se um título aparecer com destaque ou uma lista assumir uma disposição própria, isso mostra que a forma usada correspondeu a um padrão tratado pela ferramenta; não significa que todas as variantes de Markdown tenham sido interpretadas.

A contagem deve ser lida separadamente da apresentação visual. Ela diz respeito aos caracteres do texto original, enquanto a pré-visualização mostra a transformação desse conteúdo numa representação formatada. Por isso, o número não serve para contar os componentes que aparecem no resultado nem para medir a quantidade de elementos reconhecidos.

Uma pré-visualização vazia após deixar o campo sem texto é o comportamento previsto para essa entrada. Já uma entrada com conteúdo que não produz a aparência esperada merece uma análise por partes: experimente primeiro um título, uma lista ou outro padrão isolado e só depois volte a juntar os trechos. Esta abordagem ajuda a distinguir uma forma não tratada de um problema localizado na composição do texto.

Exemplo prático

Uma pessoa pretende confirmar a apresentação do título de uma nota de reunião antes de continuar a editar o documento.

Cole # Reunião no campo de texto e inicie a operação. Verifique se o conteúdo assume a apresentação de um título e se o resultado contém também a contagem relativa à entrada fornecida.

Para a entrada não vazia, o resultado bem-sucedido apresenta uma pré-visualização HTML formatada do título e inclui o número de caracteres do texto original.

Limitações

• A apresentação está limitada ao conjunto definido de padrões semelhantes a Markdown, pelo que uma construção fora dessas formas pode permanecer sem a conversão visual esperada.

Erros comuns

• Assumir que qualquer sintaxe Markdown será convertida pode produzir uma pré-visualização diferente da esperada. Isole a construção que falhou, compare-a com os padrões tratados e reformule-a usando, quando adequado, um título, uma lista, uma ligação, ênfase ou um trecho de código.

Perguntas frequentes

Que elementos semelhantes a Markdown posso testar?

Pode verificar títulos dos níveis 1 a 6, listas, ligações, imagens, citações, trechos de código, ênfase, texto riscado, separadores horizontais, linhas semelhantes a tabelas e determinadas quebras de linha. A conversão depende da forma concreta usada para cada padrão.

Tenho de introduzir texto para executar a ferramenta?

Não é obrigatório fornecer conteúdo. Quando o texto é omitido ou fica vazio, a operação é concluída com sucesso e a pré-visualização não apresenta conteúdo.

A ferramenta conta os caracteres do texto?

Sim, desde que a entrada não esteja vazia. O resultado bem-sucedido inclui a contagem de caracteres do texto original juntamente com a pré-visualização formatada.