Verificador de compatibilidade Qiita / Zenn
Qiita e Zenn são plataformas japonesas de publicação para desenvolvedores e seus dialetos de Markdown não coincidem. Cole um artigo e veja o que quebraria depois de publicar. O que tem correspondência exata é convertido, mas o resultado é um rascunho.
Cole aqui o Markdown do artigo. Se incluir o frontmatter, o título e as tags também são verificados.
O que faz e o que não faz
- A detecção cobre as 74 diferenças catalogadas: 37 são convertidas automaticamente, 14 exigem uma decisão e 23 não têm equivalente do outro lado.
- O Zenn não renderiza HTML bruto. O elemento details, o atributo width em img e as listas de definição dl que os artigos do Qiita usam não dão erro no Zenn: a tag aparece como texto para o leitor.
- Há 21 diferenças que não geram erro nem aviso. Esse tipo só aparece depois de publicado, então conte com a checagem na pré-visualização.
- O renderizador do Qiita não foi executado aqui. Tudo o que se afirma sobre a aparência final no Qiita vem da documentação oficial e da leitura do código.
- Só o corpo do texto e o frontmatter são tratados. Arquivos de imagem não são movidos nem enviados, e o que você cola não sai do navegador.
Sobre as diferenças entre Qiita e Zenn
A ferramenta diagnostica primeiro e converte depois
Qiita e Zenn são as duas grandes plataformas japonesas onde desenvolvedores publicam artigos, e ambas aceitam Markdown com extensões próprias. Entre elas há 74 diferenças catalogadas. 37 têm correspondência exata e podem ser convertidas de forma mecânica. As 51 restantes se dividem em 14 nas quais uma pessoa precisa escolher o destino e 23 que simplesmente não têm contrapartida. A conversão se aplica só a essas 37; o restante é apontado com as opções à vista.
O Zenn não renderiza HTML bruto
O renderizador do Zenn usa markdown-it com a configuração padrão, que deixa o HTML bruto desativado. Um bloco recolhível details, uma img com atributo width ou uma lista de definição dl não falham no Zenn: o texto da tag fica visível para o leitor. A compilação passa, nada avisa, e o problema aparece só com o artigo já publicado. 21 diferenças se comportam assim.
note do Qiita e message do Zenn não se correspondem
O bloco note do Qiita tem três níveis: info, warn e alert. O bloco message do Zenn tem dois: o normal e alert. Escrever :::message warn não produz bloco algum e a cadeia aparece literal no corpo. Esta ferramenta pergunta para qual dos dois níveis um bloco warn deve ir, em vez de decidir sozinha.
De Zenn para Qiita é a direção mais segura
O Qiita deixa passar o HTML bruto, então a sintaxe própria do Zenn pode ser levada como HTML. O que se perde é frontmatter que só existe no Zenn, como o emoji de capa e a marca de data de publicação, campos que o Qiita não usa. Acidentes são menos prováveis do que no sentido inverso, mas o renderizador do Qiita não foi executado aqui, então a revisão continua necessária.
Revise antes de publicar
Um slug do Zenn é único em todo o site e não pode ser alterado depois de criado. A data de publicação também fica fixa depois de definida. Publicar algo errado não pode ser desfeito, então trate o resultado como rascunho e olhe antes a pré-visualização.