Comprobador de compatibilidad Qiita / Zenn
Qiita y Zenn son plataformas japonesas de publicación para desarrolladores y sus dialectos de Markdown no coinciden. Pega un artículo y verás qué se rompería al publicarlo. Lo que tiene una correspondencia exacta se convierte, pero el resultado es un borrador.
Pega aquí el Markdown del artículo. Si incluyes el frontmatter, también se revisan el título y las etiquetas.
Lo que hace y lo que no
- La detección cubre las 74 diferencias catalogadas: 37 se convierten solas, 14 requieren una decisión y 23 no tienen equivalente al otro lado.
- Zenn no renderiza HTML sin procesar. El elemento details, el atributo width en img y las listas de definición dl que usan los artículos de Qiita no dan error en Zenn: la etiqueta aparece como texto ante el lector.
- Hay 21 diferencias que no generan ni error ni aviso. Ese tipo solo se ve una vez publicado, así que da por hecho que hará falta revisar la vista previa.
- El renderizador de Qiita no se ha ejecutado aquí. Todo lo que se afirma sobre el aspecto final en Qiita procede de la documentación oficial y de la lectura del código.
- Solo se tratan el cuerpo del texto y el frontmatter. No se mueven ni se suben archivos de imagen, y lo que pegas no sale del navegador.
Sobre las diferencias entre Qiita y Zenn
La herramienta diagnostica primero y convierte después
Qiita y Zenn son las dos grandes plataformas japonesas donde los desarrolladores publican artículos, y ambas aceptan Markdown con extensiones propias. Entre ellas hay 74 diferencias catalogadas. 37 tienen una correspondencia exacta y se pueden convertir de forma mecánica. Las 51 restantes se reparten en 14 donde una persona tiene que elegir el destino y 23 que sencillamente no tienen contrapartida. La conversión se aplica solo a esas 37; el resto se señala con las opciones a la vista.
Zenn no renderiza HTML sin procesar
El renderizador de Zenn usa markdown-it con su configuración por defecto, que deja el HTML sin procesar desactivado. Un bloque plegable details, una img con atributo width o una lista de definición dl no fallan en Zenn: el texto de la etiqueta se vuelve visible para el lector. La compilación pasa, nada avisa, y el problema aparece solo con el artículo ya publicado. Así se comportan 21 diferencias.
note de Qiita y message de Zenn no se corresponden
El bloque note de Qiita tiene tres niveles: info, warn y alert. El bloque message de Zenn tiene dos: el normal y alert. Escribir :::message warn no produce ningún bloque y la cadena aparece literal en el cuerpo. Esta herramienta pregunta a cuál de los dos niveles debe ir un bloque warn en lugar de decidirlo por su cuenta.
De Zenn a Qiita es la dirección más segura
Qiita deja pasar el HTML sin procesar, así que la sintaxis propia de Zenn puede trasladarse como HTML. Lo que se pierde es frontmatter que solo existe en Zenn, como el emoji de portada y la marca de fecha de publicación, campos que Qiita no usa. Los accidentes son menos probables que en el sentido contrario, pero el renderizador de Qiita no se ha ejecutado aquí, así que la revisión sigue siendo necesaria.
Revisa antes de publicar
Un slug de Zenn es único en todo el sitio y no se puede cambiar una vez creado. La fecha de publicación también queda fija tras establecerla. Publicar algo equivocado no se puede deshacer, así que trata el resultado como un borrador y mira antes la vista previa.