Repolode
Enviar
vale-cli

vale-cli/vale

Un linter de texto para la línea de comandos que aplica las reglas de estilo de escritura de tu equipo en editores, CI y código, sin conexión.

Alternativa open source a:Grammarly

Ver en GitHubSitio web
Estrellas
6,278
Forks
236
Issues abiertos
23
Último commit
hace 6 días

¿Qué es?

Vale es un linter de texto que convierte las pautas de escritura en comprobaciones automáticas. No impone criterios propios: los equipos pueden elegir una guía de estilo publicada, como las de Microsoft o Google, añadir sus propios términos o combinar ambas opciones. Vale aplica esas reglas a Markdown, AsciiDoc, reStructuredText, HTML y otros formatos de documentos.

Vale analiza el marcado de los documentos con parsers reales, por lo que las reglas pueden apuntar a encabezados, listas o celdas de tablas, y omitir fragmentos de código, URL y bloques delimitados. También extrae comentarios y docstrings del código fuente mediante gramáticas de tree-sitter, y puede analizar texto incluido en archivos como descripciones de OpenAPI, celdas de notebooks o mensajes de commit.

Las reglas se escriben en archivos YAML y abarcan desde sustituciones sencillas de términos hasta patrones de categorías gramaticales, fórmulas de legibilidad y scripts. Algunas incluyen correcciones que los editores o agentes pueden aplicar. Vale está escrito en Go, se distribuye como un único binario, funciona en macOS, Windows y Linux, y opera completamente sin conexión.

Funciones clave

  • 01Analiza Markdown, AsciiDoc, reStructuredText, HTML y otros formatos de marcado antes de aplicar las reglas.
  • 02Extrae comentarios y docstrings del código fuente para revisarlos.
  • 03Reglas escritas en YAML, desde sustituciones de términos hasta comprobaciones de categorías gramaticales y legibilidad.
  • 04Incluye paquetes de estilo publicados, como los de Microsoft y Google, que se pueden sincronizar con un solo comando.
  • 05Las reglas pueden incluir correcciones automáticas que los editores y agentes pueden aplicar.
  • 06Funciona sin conexión en macOS, Windows y Linux como un único binario de Go.

Casos de uso

  • Aplicar una guía de estilo de empresa o proyecto en toda la documentación técnica.
  • Detectar inconsistencias terminológicas, como nombres de productos en la documentación.
  • Ejecutar comprobaciones de texto en CI para validar automáticamente las pull requests de documentación.
  • Analizar docstrings y comentarios del código junto con el código que describen.

Inicio rápido

  1. 1

    Instala Vale con Homebrew en macOS

    brew install vale
  2. 2

    Crea un archivo de configuración .vale.ini en la raíz del proyecto

  3. 3

    Descarga los estilos configurados

    vale sync
  4. 4

    Analiza un archivo, como README.md, con el linter

    vale README.md

Antes de usarlo

  • En algunas plataformas solo se indica la instalación mediante Go; para otras opciones se necesita el gestor de paquetes disponible en el sistema.
  • Vale está desarrollado principalmente por una sola persona, por lo que el soporte y la velocidad de desarrollo dependen de ella.

En colecciones

Herramientas de CLI y terminal

Temas

#linter#documentation#prose#markdown#style-guide#cli#writing#ci#linting#vale

Preguntas frecuentes

¿Qué es vale?
Un linter de texto para la línea de comandos que aplica las reglas de estilo de escritura de tu equipo en editores, CI y código, sin conexión. Vale es un linter de texto que convierte las pautas de escritura en comprobaciones automáticas. No impone criterios propios: los equipos pueden elegir una guía de estilo publicada, como las de Microsoft o Google, añadir sus propios términos o combinar ambas opciones. Vale aplica esas reglas a Markdown, AsciiDoc, reStructuredText, HTML y otros formatos de documentos.
¿vale es gratuito? ¿Qué licencia tiene?
vale es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿vale sigue mantenido?
Mantenimiento activo. El último commit de vale fue el 16 oct 2026.
¿Para qué puedo usar vale?
Aplicar una guía de estilo de empresa o proyecto en toda la documentación técnica. Detectar inconsistencias terminológicas, como nombres de productos en la documentación. Ejecutar comprobaciones de texto en CI para validar automáticamente las pull requests de documentación. Analizar docstrings y comentarios del código junto con el código que describen.
¿Cómo se instala vale?
Instala Vale con Homebrew en macOS: brew install vale Crea un archivo de configuración .vale.ini en la raíz del proyecto Descarga los estilos configurados: vale sync Analiza un archivo, como README.md, con el linter: vale README.md
¿Dónde consigo vale?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/vale-cli/vale

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados