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.
Nesta página
01Reproduz três erros visíveis02Quando a mesma fonte se comporta de forma diferenteUm 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.
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.
- Acrescenta um espaço depois do marcador do título:
#Exportpassa a# Export. A primeira linha pode então ser interpretada como título. - 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. - 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)
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.
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.
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.