Validador Markdown
Valida sintaxis Markdown y detecta errores online. Verifica espaciado de encabezados, cercas de código sin cerrar, formato de listas y cumplimiento de CommonMark.
Markdown de Entrada
Informe de Validación
¿Qué es un Validador Markdown?
Un validador markdown es una herramienta que verifica si los archivos markdown se adhieren a las especificaciones de sintaxis y se renderizan sin errores. A diferencia de un linter que impone preferencias de estilo, un validador se enfoca en la corrección, garantizando que tu markdown sea estructuralmente correcto y se muestre correctamente en cualquier plataforma. El validador identifica elementos rotos como cercas de código sin cerrar, enlaces malformados, niveles de encabezado inválidos y problemas de alineación de tabla que de otro modo causarían fallos de renderizado o problemas de visualización.
La especificación CommonMark proporciona el estándar de referencia que utilizan todos los validadores markdown. CommonMark es una versión racional y bien documentada de markdown que elimina ambigüedades del formato original, facilitando la construcción de analizadores y validadores confiables. Este validador basado en navegador verifica tu contenido contra las reglas de CommonMark instantáneamente, detectando problemas antes de publicar en plataformas como GitHub, GitLab o generadores de sitios estáticos.
Cuando validas markdown, esencialmente estás preguntando: "¿Se renderizará esto correctamente en todas partes?" Un validador detecta problemas sutiles que son invisibles hasta el momento de vista previa: bloques de cercas de código sin cerrar que exponen markdown sin procesar, errores de sintaxis de enlace, estructuras de tabla rotas y rutas de imagen que no se cargan. Esto es particularmente importante en flujos de trabajo de documentación donde un solo error de renderizado puede confundir a los lectores o romper la navegación.
Cómo Usar el Validador Markdown
Sigue estos pasos para validar tu Markdown. Cada paso utiliza los botones y paneles reales en esta página.
Pegar, Subir o Cargar Ejemplo
Pega Markdown en el panel izquierdo de Markdown de Entrada, o haz clic en Subir para cargar un archivo .md. Haz clic en Ejemplo para ver documentos de API de suscriptor de ejemplo con problemas intencionales para validación. Verifica contra CommonMark.
Ver Informe de Validación
El panel derecho de Informe de Validación lista errores y advertencias con números de línea. Detecta cercas de código sin cerrar, enlaces malformados, encabezados inválidos, tablas.
Copiar o Descargar Informe
Haz clic en Copiar o Descargar para usar el informe. Usa Limpiar para empezar de nuevo. Todo el procesamiento se ejecuta en tu navegador.
Cuándo Realmente Usarías Esto
Verificación Previa a la Publicación
Antes de publicar contenido en GitHub, GitLab, Notion o un generador de sitios estáticos, ejecuta la validación para detectar errores de renderizado. Detectar cercas de código rotas o tablas malformadas antes de la publicación evita errores embarazosos en la documentación de producción.
Calidad de Documentación de API
Valida markdown utilizado en documentos de API, especificaciones de OpenAPI y documentación de SDK. Asegura que los ejemplos de código en bloques cercados se rendericen correctamente, los enlaces funcionen y las tablas que muestran parámetros sean estructuralmente correctas. Herramientas como Swagger se basan en markdown válido.
Migración de Blog y Contenido
Al migrar contenido de blog de HTML u otros formatos a markdown, valida que el markdown convertido sea estructuralmente correcto. Detecta artefactos de conversión como caracteres escapados, enlaces rotos y tablas malformadas.
Accesibilidad y Cumplimiento Semántico
Asegura que tu markdown siga una estructura semántica con niveles de encabezado adecuados y texto alternativo en imágenes. Una estructura de markdown válida es crucial para lectores de pantalla y produce una salida final más accesible cuando se renderiza a HTML.
Preguntas Frecuentes (FAQ)
¿Qué dialecto markdown soporta este validador?
Este validador sigue estrictamente la especificación CommonMark, que es el formato markdown más portátil y estandarizado. GitHub Flavored Markdown (GFM) extiende CommonMark con tablas, tachado y listas de tareas. Para características específicas de GFM, valida contra las extensiones de GitHub.
¿Cuál es la diferencia entre errores de validación y advertencias?
Los errores son problemas estructurales que evitan la renderización correcta: cercas de código sin cerrar, sintaxis de enlace rota, secuencias de encabezado inválidas. Las advertencias señalan problemas que podrían no romper la renderización pero indican prácticas pobres o problemas potenciales de accesibilidad. Ambos deben abordarse antes de publicar.
¿Puedo validar markdown específicamente para GitHub?
Esta herramienta valida el cumplimiento de CommonMark. GitHub usa GitHub Flavored Markdown, que extiende CommonMark con tablas, listas de tareas y tachado. El contenido que pase este validador funcionará en GitHub, pero las características específicas de GitHub no se validarán aquí. Verifica la documentación de markdown de GitHub para reglas específicas del sabor.
¿El validador verifica la ortografía o la gramática?
No, el validador se enfoca únicamente en la sintaxis y estructura de markdown. Para verificación de ortografía y gramática, utiliza herramientas separadas como Grammarly o extensiones de IDE. El validador asegura que tu markdown sea estructuralmente válido y se renderice correctamente.
¿Cómo corrijo errores de validación?
Cada error incluye el número de línea y la descripción. Correcciones comunes: cierra cercas de código sin cerrar con comillas invertidas coincidentes, corrige la sintaxis de enlace asegurando que los corchetes y paréntesis coincidan, alinea correctamente las columnas de tabla, añade texto alternativo faltante a imágenes y asegura que los encabezados sigan una secuencia lógica (H1 → H2 → H3, no H1 → H3).
¿Se envían datos de validación a algún servidor?
No. Toda la validación se ejecuta completamente en tu navegador usando JavaScript. Tu contenido markdown nunca se transmite a ningún lugar, lo que hace esto seguro para documentación propietaria, privada o sensible.