Comprobación de portabilidad de Markdown
Pega código fuente Markdown y descubre qué elementos se mostrarán de forma distinta o fallarán según dónde se consulte: GitHub, un renderizador CommonMark estricto o uno simplificado, como versiones antiguas de Reddit.
El análisis se realiza localmente en tu navegador. El archivo nunca se carga al servidor.
Cómo usar esta herramienta
- Pega el código fuente Markdown o el contenido de un README/documento. El texto se procesa en el navegador y no se envía.
- Selecciona «Comprobar portabilidad».
- Revisa cada elemento señalado, por qué puede no ser compatible y qué renderizadores discrepan.
- Aplica la reescritura sugerida cuando exista; muchos casos no se pueden corregir automáticamente sin adivinar la intención.
Supuestos
- Detecta siete casos concretos: URL sin formato, bloques de código con sangría de tabulación, tablas GFM, tachado GFM, listas de tareas GFM, enlaces o imágenes de referencia sin definición coincidente y bloques HTML sin procesar con etiquetas que suelen filtrarse. El resto del renderizado Markdown queda fuera de alcance.
- Es un analizador de texto por líneas, no un analizador Markdown completo: no crea un árbol del documento y omite deliberadamente el contenido de bloques de código cercados.
- Un enlace o imagen de referencia solo se señala si no existe en el documento una definición para su etiqueta; la comparación no distingue mayúsculas, conforme a CommonMark.
Fuentes y datos de referencia
Metodología
Cada caso se detecta mediante patrones específicos, excluyendo los bloques de código cercados, y se contrasta con diferencias documentadas entre GitHub-Flavored Markdown, CommonMark y renderizadores simplificados habituales. Solo se sugiere una reescritura cuando es segura y no ambigua, como encerrar una URL sin formato entre ángulos. No se inventa el destino de una referencia ausente ni se reescriben silenciosamente elementos GFM válidos e intencionados.
Ejemplo resuelto
Una URL sin formato ni sintaxis de enlace
Datos de entrada: Consulta https://example.com para más detalles.
Resultado: GFM la convierte automáticamente en enlace; CommonMark estricto puede dejarla como texto sin enlace. Se señala como aviso y se puede reescribir como «Consulta <https://example.com> para más detalles.»
Un enlace de referencia sin definición coincidente
Datos de entrada: Lee la [guía de migración][ref-ausente] antes de actualizar.
Resultado: No hay ninguna definición «[ref-ausente]: URL» en el documento. El enlace se muestra como sintaxis literal o rota en todos los renderizadores. Se señala como error, sin proponer un destino inventado.
Una tabla GFM con barras verticales
Datos de entrada: | Nombre | Edad | |------|-----| | Ada | 30 |
Resultado: Las tablas con barras son una extensión de GitHub-Flavored Markdown, no de CommonMark básico. Se señala como información; un renderizador CommonMark puede mostrar barras y guiones como texto.
Orientación práctica
- Encierra una URL sin formato entre ángulos o conviértela en un enlace [texto](url) si el documento puede leerse con CommonMark estricto.
- Prefiere bloques de código cercados con ``` a los bloques con sangría de tabulaciones o espacios.
- Verifica los destinos y las etiquetas de todos los enlaces e imágenes de referencia: una definición ausente o mal escrita es un error real.
- Evita etiquetas HTML sin procesar como <script>, <iframe>, <style>, <object> y <embed> en Markdown público; es habitual que se filtren.
Errores comunes
- Suponer que las tablas o listas de tareas funcionarán en todas partes porque se ven bien en GitHub: las extensiones GFM no forman parte de CommonMark.
- Tratar un enlace de referencia roto como una diferencia de portabilidad; a diferencia de otros avisos, falla en todos los renderizadores.
Preguntas frecuentes
¿Por qué una URL sin formato es un aviso y un enlace de referencia roto es un error?
La URL sigue siendo texto legible aunque no se convierta en enlace. Una referencia rota aparece como sintaxis literal o como enlace ausente en todos los renderizadores, por lo que sí es un fallo funcional.
¿Por qué la herramienta no convierte tablas GFM o listas de tareas?
CommonMark básico no tiene conceptos equivalentes de tabla o casilla. La herramienta señala la dependencia de GFM para que decidas si es aceptable; una conversión automática podría cambiar la estructura o el significado.
¿Se comprueba el contenido de los bloques de código cercados?
No. El texto entre cercas ``` se omite deliberadamente porque se presenta literalmente y no se interpreta como sintaxis Markdown. Una URL o un ~~tachado~~ de ejemplo dentro de ese bloque no se considera un problema.
¿Por qué se ve una tabla Markdown en GitHub, pero no en CommonMark?
Las tablas con barras son una extensión de GitHub-Flavored Markdown, no de CommonMark básico. Un renderizador que solo implemente CommonMark puede mostrar las barras y la fila separadora como texto. Esta herramienta identifica esa diferencia, pero no compara todos los renderizadores.
Última revisión:
Es un analizador acotado por líneas, no un analizador Markdown completo: reconoce siete elementos concretos y no analiza otros casos límite de CommonMark/GFM, como ambigüedades de énfasis anidado, notas al pie, casos límite de autenlaces o entidades HTML. Tampoco puede saber el destino previsto de una referencia rota y no inventa una corrección.
Esta herramienta ofrece una estimación orientativa basada en los supuestos indicados arriba.
Las preferencias de tema y de herramientas, junto con las listas de herramientas guardadas y recientes, se almacenan solo en este navegador.