Mensagens de erro do Markdown
Lista das mensagens da validação do Markdown Converto — o que significam e como corrigir (erros bloqueiam; avisos não).
Avançado3 min de leitura
A validação do Markdown separa erros (impedem a construção) de avisos (a página é construída, mas algo foi ignorado ou merece revisão). Mensagens de sintaxe trazem o número da linha.
Erros
| Mensagem | Causa | Correção |
|---|---|---|
| "Nenhuma seção "<!-- converto:<id> -->" encontrada no Markdown." | O documento não tem nenhuma seção. | Inclua ao menos uma linha <!-- converto:ID -->. |
| "Identificador de widget vazio em "<!-- converto: -->"." | Falta o ID depois dos dois-pontos. | Escreva o ID, por exemplo hero-01. |
| "Widget "…" não existe (linha N)." | ID inexistente. | Use um ID da Biblioteca de widgets. |
| "Campo obrigatório "…" ausente no widget "…"." | Falta um campo obrigatório. | Preencha o campo (veja a tabela de campos do widget). |
| "Campo obrigatório "…" está vazio…" / "Repeater obrigatório "…" está vazio…" | Campo ou lista obrigatória sem valor. | Informe o valor ou ao menos um item. |
| "Campo "…" do widget "…" deveria ser uma lista (repeater), mas não é." | Lista escrita como texto. | Use itens com - . |
| "Bloco ":::…" nunca foi fechado com ":::"." | Falta o fechamento. | Feche cada bloco com uma linha :::. |
| "Bloco desconhecido ":::…" (esperado :::content ou :::style)." | Nome de bloco inválido. | Use :::content ou :::style. |
| "Front matter aberto com "---" nunca foi fechado." | Falta o --- final. | Feche o front matter. |
| "Linha inválida no front matter: …" | Linha fora do formato chave: valor. | Corrija a linha. |
| "converto_version "…" não é suportada (suportadas: 1)." | Versão da linguagem inválida. | Use converto_version: 1. |
| "Linha malformada (esperado "campo: valor"): …" | Linha de bloco sem campo: valor. | Corrija o formato. |
| "Indentação inesperada: …" | Indentação inconsistente. | Alinhe a indentação (use espaços; tabs viram 4 espaços). |
| "URL com esquema não permitido… javascript:, data: e vbscript: são bloqueados." | URL perigosa. | Use http(s)://, #âncora ou mailto:. |
| "…exigem a capability unfiltered_html, que o usuário atual não tem." | Uso de custom_css, custom_js ou códigos sem a permissão. | Remova os campos de código ou use um usuário com a permissão. |
| "Imagem "…" … ficaria com o placeholder padrão: crie uma imagem nova…" | Campo de imagem obrigatória deixado com a imagem de exemplo. | Envie e informe a imagem do projeto. |
Avisos
| Mensagem | Significado |
|---|---|
| "Chave "…" do front matter não é uma opção de página conhecida e será ignorada." | Chave desconhecida. |
| "Campo "…" não é suportado pelo widget "…" e será ignorado." | O campo não existe no contrato; foi descartado. |
| "Valor "…" do campo "…" não está entre as opções conhecidas (…)." | Valor fora das opções do campo. |
| "A página tem N heros (…): use só um, a primeira dobra é única." | Mais de um hero. |
| "O "header" deveria ser a primeira seção da página." / "O "footer" deveria ser a última seção da página." | Ordem fora do padrão. |
| "Campo "…" parece um mapa em linha, que não é suportado; use bloco indentado…" | Fundo escrito em linha; foi tratado como cor sólida. |
| "…não declara "type"; aplicado "classic"…" / "Tipo de fundo "…" … não é permitido…" | Tipo de fundo ausente ou inválido. |
| "URL suspeita no campo "…"." | Endereço com formato estranho; revise. |
| "Valor de medida "…" … inválido e será normalizado para 0." | Medida inválida. |
| Aviso de imagem com placeholder (campos opcionais) | A imagem de exemplo foi mantida. |
Dicas
- Corrija sempre os erros primeiro; avisos geralmente indicam campo ignorado.
- Compare o nome de cada campo com a página do widget na Biblioteca de widgets.
- Em dúvida de sintaxe, volte para A linguagem Markdown Converto.
Este artigo foi útil?
Artigos relacionados
IA e Markdown
A linguagem Markdown Converto
Guia da sintaxe — seções, blocos :::content e :::style, listas, valores responsivos, fundos e as regras que toda página deve seguir.
IA e Markdown
Converto Construtor
Monte uma página inteira a partir de um arquivo Markdown dentro do editor — passo a passo, estrutura detectada, reordenação e o que o assistente não faz.
IA e Markdown
Especificação pública para IA
A URL de aprendizado do Converto — o que a rota /spec expõe, como pedir o contrato completo de widgets e o que exige login.