Ir para o conteúdo
Voltar ao Blog
segunda-feira, 2 de novembro de 2026

Erros de Markdown: reproduzir, corrigir e exportar

Corrige títulos, listas de tarefas e ligações com um exemplo reproduzível de antes e depois e verifica a imagem Markdown exportada.

Erros de Markdown: reproduzir, corrigir e exportar

Um documento Markdown com erros continua muitas vezes a ser apresentado, mas com a estrutura errada. Usa o conversor Markdown como pré-visualização enquanto isolas a causa. Corrige primeiro o menor fragmento que falha e aplica depois a alteração ao documento completo.

Reproduz três erros visíveis

Cola esta lista propositadamente incorreta no editor. Falta o espaço no título, os marcadores de lista estão unidos às caixas de verificação e a ligação não tem parênteses à volta do endereço.

#Export check

**Status:** Ready for review

-[x] Heading checked
-[x] List spacing checked
-[ ] Final export inspected

[Open the converter]https://markdowntoimage.com/converter

Procura sinais literais onde esperavas uma estrutura. Mudar o tema não corrige estes marcadores. O conteúdo é demonstrativo, por isso podes alterá-lo sem mexer numa lista real de publicação.

Corrige a fonte e compara o resultado

  1. Acrescenta um espaço depois do marcador do título: #Export passa a # Export. A primeira linha pode então ser interpretada como título.
  2. Separa o marcador de lista da caixa: -[x] passa a - [x]. Também é necessário um espaço entre a caixa e o respetivo texto. As listas de tarefas são uma extensão GFM que o renderizador tem de suportar.
  3. Coloca o destino entre parênteses: [label](URL). Os parênteses retos contêm o texto visível e os curvos, o endereço. Testa a ligação no documento apresentado; a cor numa imagem não prova que funciona.

Este é o conteúdo completo corrigido e o resultado exportado:

# Export check

**Status:** Ready for review

- [x] Heading checked
- [x] List spacing checked
- [ ] Final export inspected

[Open the converter](https://markdowntoimage.com/converter)

Lista de exportação corrigida com título, estado destacado e três tarefas

O título, o estado e as tarefas distinguem-se agora claramente. A última tarefa fica por marcar de propósito: uma pré-visualização arrumada não significa que o ficheiro exportado tenha sido inspecionado.

Quando a mesma fonte se comporta de forma diferente

Um editor pode suportar funcionalidades que outro não reconhece. Consulta a especificação CommonMark para a sintaxe base e a especificação GFM para extensões como tabelas e listas de tarefas. Mantém o fragmento pequeno para poderes comparar renderizadores.

Se um item aninhado sair da lista principal, verifica a indentação em vez de acrescentares espaços por todo o documento. Se um parágrafo aparecer como código, procura uma cerca por fechar mais acima. Para apresentar sinais literalmente, usa código em linha ou o escape adequado, sem apagar caracteres necessários.

Verifica o ficheiro que vais partilhar

Exporta quando a pré-visualização corresponder à estrutura pretendida. Abre a imagem descarregada e lê o primeiro título, o texto de todas as tarefas e a última linha. Inclui a ligação de ação no texto à volta da imagem: uma imagem contém píxeis, não ligações Markdown clicáveis. Guarda a fonte editável para não teres de reconstruir tudo na próxima correção.

Corrige e exporta a tua lista. Continua no guia prático de Markdown ou no guia de blocos de código para resolver problemas de cercas e realce.