Validador Markdown
Valide a sintaxe Markdown e detete problemas comuns como cercas não fechadas, links quebrados e tabelas mal formadas — tudo no navegador.
Markdown de entrada
Relatório de validação
Exemplos de validação Markdown
O Markdown válido tem espaçamento correto e cercas fechadas. Exemplos:
Markdown válido
Inválido – espaço em falta após título e cerca de código não fechada
#API precisa de um espaço após #. Ao bloco de código falta o fecho ```.
Cole qualquer exemplo no editor acima. Utilize Amostra para carregar mais dados.
O que é um validador Markdown?
Markdown tem regras de sintaxe. Cercas de código não fechadas, ligações quebradas, tabelas mal formadas ou HTML inválido podem causar problemas de renderização. Um validador Markdown verifica o seu documento e reporta problemas comuns. A especificação CommonMark define a sintaxe.
Esta ferramenta analisa o seu Markdown e gera um relatório de validação. Executa-se inteiramente no seu browser. Nada é enviado para um servidor. Para formatar: Formatador Markdown. Para lint (regras de estilo): Linter Markdown.
Como utilizar esta ferramenta
Colar ou carregar Markdown
Copie o seu Markdown e cole-o no editor da esquerda. Também pode clicar em Carregar para carregar um ficheiro .md ou .markdown. O botão Amostra carrega dados de exemplo.
Verificar o relatório de validação
O painel da direita mostra o relatório. Lista problemas como cercas não fechadas, ligações de referência quebradas, tabelas mal formadas ou títulos vazios. Transfira o relatório para partilhar.
Corrigir e revalidar
Corrija os problemas na entrada e revalide. Para formatar: Formatador Markdown. Para converter para HTML: Markdown para HTML.
Quando a validação Markdown ajuda
Ao publicar documentação, READMEs ou conteúdo em GitHub, GitLab ou sites estáticos como Jekyll e Hugo, a validação deteta problemas antes de causarem renderização quebrada. A especificação GFM define tabelas e extensões. Blocos de código não fechados ou tabelas mal formadas podem quebrar páginas inteiras. Executar o seu Markdown aqui dá confiança antes de merge ou deploy.
Conteúdo de múltiplos autores ou Markdown gerado por IA frequentemente tem erros subtis. Validar aqui fornece uma lista de verificação. Para consistência de estilo (ex.: níveis de título, formatação de listas): Linter Markdown.
Perguntas frequentes
O que a validação Markdown verifica?
O validador verifica problemas comuns de Markdown: níveis de título saltados (ex.: passar de H1 para H3), blocos de código não fechados, sintaxe de link mal formada [texto](url), indentação de lista inconsistente e marcadores de título vazios. Não impõe um guia de estilo — verifica erros estruturais.
Markdown válido significa que renderizará correctamente em todo o lado?
Não necessariamente. Diferentes parsers Markdown têm regras diferentes — um documento válido em CommonMark pode renderizar diferente no GitHub ou Notion. A validação detecta erros de sintaxe mas não pode garantir consistência visual em todos os renderers.
Posso validar um ficheiro README?
Sim — cole todo o conteúdo do README.md e o validador verificará os problemas estruturais. Isto é especialmente útil antes de fazer commit no GitHub para detetar problemas de formatação cedo.
Existe um limite de tamanho para validação?
Sem limites do lado do servidor — a validação executa-se inteiramente no seu browser. Os ficheiros README típicos e páginas de documentação são validados instantaneamente independentemente do tamanho.
Ferramentas relacionadas
Saiba mais: CommonMark, especificação CommonMark, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, GitLab, Hugo.