Markdown de entrada

Informe de lint

Ejemplos de lint Markdown

El linter marca problemas de estilo: líneas largas, saltos de encabezado, marcadores de lista mixtos. Ejemplo:

Markdown con problemas comunes

Línea larga, salto de encabezado (H2 a H3 saltando H1), marcadores de lista mixtos - y *.

Ejemplo

Pegue en el editor de arriba para ver el informe de lint. Use Ejemplo para cargar más.

¿Qué es un linter Markdown?

Publicas documentación en GitHub, pegas en Notion o publicas en un sitio de documentación — y en algún momento la jerarquía de encabezados está rota, un marcador de lista es inconsistente o faltan líneas en blanco alrededor de bloques de código. Un linter Markdown detecta estas cosas antes de que se conviertan en problemas visibles. Esta herramienta verifica tu Markdown contra reglas de estilo comunes: orden de encabezados, marcadores de lista consistentes, líneas en blanco alrededor de bloques y longitud de línea. La especificación CommonMark define la sintaxis base, y la especificación GitHub Flavored Markdown (GFM) define las extensiones que más se usan. El informe de lint muestra los problemas por número de línea y severidad.

Esta herramienta se ejecuta completamente en su navegador. Su Markdown se analiza localmente—no se envía nada a ningún servidor. El informe de lint lista problemas por línea con severidad (Error, Advertencia, Info). Para formatear Markdown: Formateador Markdown. Para validación: Validador Markdown.

Cómo usar esta herramienta

1

Pegar o subir

Pegue su Markdown en el editor izquierdo o haga clic en Subir para cargar un archivo .md, .markdown o .txt. Use Ejemplo para cargar datos de ejemplo con problemas comunes.

2

Revisar el informe de lint

El panel derecho muestra el informe de lint con números de línea y descripciones. Corrija problemas en el editor izquierdo; el informe se actualiza automáticamente. Use Copiar o Descargar para guardar el informe.

3

Corregir y re-lint

Aborde cada problema y vuelva a ejecutar. Para convertir Markdown a HTML: Markdown a HTML. Para TOC desde encabezados: Generador TOC Markdown.

Cuándo ayuda el lint Markdown

Antes de hacer commit de docs en GitHub o publicar en un CMS, el lint detecta problemas que podrían romper el renderizado o confundir a los lectores. Las jerarquías de encabezados inconsistentes hacen los TOC poco fiables. Los enlaces de referencia rotos causan 404s. Ejecutar su Markdown aquí mejora la calidad antes del review.

Los sitios de documentación, archivos README y entradas de blog se benefician de Markdown consistente. Para convertir a HTML: Markdown a HTML. Para generar tabla de contenidos desde encabezados: Generador TOC Markdown. Para referencia de sintaxis: Markdown Cheat Sheet.

Preguntas frecuentes

¿Son seguros mis datos Markdown aquí?

Completamente seguro. Todo el proceso de lint se ejecuta en el navegador con JavaScript — no se envía nada a ningún servidor. Puedes verificarlo abriendo la pestaña Red del navegador: no verás ninguna solicitud saliente.

¿Qué comprueba exactamente?

Las comprobaciones típicas incluyen consistencia de niveles de encabezado, líneas en blanco alrededor de encabezados y bloques de código, consistencia de marcadores de lista, longitud de línea y conformidad CommonMark/GFM. Las reglas exactas dependen de la implementación.

¿Cuál es la diferencia entre un linter y un validador?

Un linter se centra en el estilo y las buenas prácticas — cosas que son técnicamente válidas pero inconsistentes. Un validador comprueba que la sintaxis se analiza correctamente. Para validación de sintaxis, prueba Validador Markdown.

¿Soporta GitHub Flavored Markdown?

Sí. La mayoría de los linters soportan extensiones de GitHub Flavored Markdown como tablas, listas de tareas y tachado. Comprueba el informe para problemas específicos de GFM.

¿Puede corregir problemas automáticamente?

Esta herramienta reporta problemas para que los corrijas manualmente. Para correcciones automáticas de espacios en blanco y saltos de línea, usa el Formateador Markdown.

Herramientas relacionadas

Para sintaxis Markdown: CommonMark y CommonMark spec. GitHub Flavored Markdown lo extiende. Markdown Guide ofrece tutoriales. Véase también GitHub, W3C HTML y Jekyll.