Linter Markdown

Comprueba Markdown por problemas de estilo: niveles de encabezado, cercas de código, consistencia de listas y más (motor de reglas sin dependencias)

Datos clave

Categoría
Desarrollo y Web
Tipos de entrada
textarea, select
Tipo de salida
text
Cobertura de muestras
4
API disponible
Yes

Resumen

El Linter Markdown es una herramienta diseñada para analizar y validar la estructura de tus archivos Markdown, detectando problemas de estilo como niveles de encabezado incorrectos, inconsistencias en listas y errores en bloques de código sin necesidad de dependencias externas.

Cuándo usarlo

  • Antes de publicar documentación técnica o artículos de blog para asegurar un formato limpio y profesional.
  • Al integrar flujos de trabajo de integración continua donde se requiera validar la sintaxis de archivos Markdown.
  • Cuando necesites identificar rápidamente saltos de nivel en encabezados o inconsistencias en el estilo de las listas.

Cómo funciona

  • Pega el texto Markdown que deseas analizar en el campo de entrada principal.
  • Selecciona el conjunto de reglas deseado (Estándar, Relajado o Estricto) según el nivel de rigurosidad que requieras.
  • Elige el formato del informe de salida, ya sea en texto plano para lectura rápida o en formato JSON para su procesamiento automatizado.
  • Haz clic en procesar para obtener un informe detallado con las advertencias y errores de estilo detectados.

Casos de uso

Revisión de archivos README.md antes de subirlos a repositorios públicos como GitHub o GitLab.
Validación de la estructura de encabezados en artículos extensos para optimizar la accesibilidad y el SEO.
Auditoría de consistencia de estilo en documentación técnica colaborativa escrita por múltiples autores.

Ejemplos

1. Corrección de niveles de encabezado en documentación técnica

Redactor Técnico
Contexto
Un redactor está preparando un manual de usuario extenso en Markdown, pero sospecha que se saltó algunos niveles de encabezado (por ejemplo, pasar de H2 a H4 directamente).
Problema
Identificar visualmente y de forma rápida dónde se rompe la jerarquía de los títulos en un documento de más de mil líneas.
Cómo usarlo
Pega el contenido del manual en el área de texto, selecciona el conjunto de reglas 'Estricto' y el formato de informe 'Informe de Texto'.
Configuración de ejemplo
markdownInput: [Contenido del manual], ruleSet: 'strict', reportFormat: 'text'
Resultado
El linter genera un reporte indicando las líneas exactas donde los encabezados no siguen un orden jerárquico consecutivo.

2. Validación automatizada de formato para blogs

Desarrollador Web
Contexto
Un desarrollador gestiona un blog estático basado en Markdown y quiere validar que las publicaciones de los colaboradores externos cumplan con las reglas de estilo estándar antes de compilarlas.
Problema
Validar de forma estructurada que no haya bloques de código sin cerrar o listas con viñetas inconsistentes.
Cómo usarlo
Introduce el borrador del artículo en la entrada, selecciona el conjunto de reglas 'Estándar' y define el formato de informe como 'JSON'.
Configuración de ejemplo
markdownInput: [Borrador del artículo], ruleSet: 'standard', reportFormat: 'json'
Resultado
Se obtiene un objeto JSON con la lista de advertencias detallando la línea, columna y tipo de regla infringida para su fácil procesamiento.

Probar con muestras

markdown

Hubs relacionados

Preguntas frecuentes

¿Qué tipo de errores detecta este linter de Markdown?

Detecta problemas de estilo como niveles de encabezado desordenados, inconsistencias en viñetas de listas, bloques de código mal cerrados y espacios en blanco innecesarios.

¿Cuál es la diferencia entre los conjuntos de reglas Estándar, Relajado y Estricto?

El modo estricto aplica todas las reglas de estilo de forma rigurosa, el estándar cubre las mejores prácticas comunes y el relajado omite advertencias menores de espaciado o puntuación.

¿Puedo exportar el informe de errores en formato JSON?

Sí, puedes configurar la opción de formato de informe a JSON para integrarlo fácilmente con otros scripts o herramientas de desarrollo.

¿Esta herramienta modifica o corrige mi archivo Markdown automáticamente?

No, esta herramienta solo analiza y reporta los errores de estilo detectados para que puedas corregirlos de manera controlada.

¿Requiere conexión a internet o dependencias externas para funcionar?

No, el motor de reglas se ejecuta de forma local y directa en tu navegador sin dependencias externas.

Documentación de la API

Punto final de la solicitud

POST /es/api/tools/markdown-linter

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
markdownInput textarea -
ruleSet select No -
reportFormat select No -

Formato de respuesta

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
Texto: Texto

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-markdown-linter": {
      "name": "markdown-linter",
      "description": "Comprueba Markdown por problemas de estilo: niveles de encabezado, cercas de código, consistencia de listas y más (motor de reglas sin dependencias)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=markdown-linter",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]