Cómo se usa
- Elija la sangría en Sangrar con y Tamaño de la sangría. Elija el salto de línea en Fin de línea y la codificación en Juego de caracteres.
- Marque las secciones por tipo de archivo que necesite: Mantener los espacios finales en Markdown, Sangrar YAML con dos espacios y Sangrar las recetas de Makefile con tabuladores.
- Copie el texto de El archivo .editorconfig, o descárguelo, y guárdelo en la carpeta superior de su proyecto.
- Lea Qué significa cada línea para comprobar lo que hace cada propiedad.
Cómo funciona el archivo
Muchos editores y entornos de desarrollo leen un archivo .editorconfig y aplican sus ajustes a los archivos que coinciden con cada sección. Un encabezado de sección es un patrón de nombres de archivo entre corchetes, y las propiedades bajo él se aplican a cada archivo que coincida. Una sección posterior sustituye a una anterior para la misma propiedad. La línea root = true detiene la búsqueda, así que los ajustes llegan solo a esta carpeta y a las que hay debajo.
- * coincide con cualquier carácter menos la barra.
- ** coincide con cualquier carácter, también con barras.
- {yml,yaml} coincide con cualquiera de los dos textos, así que *.{yml,yaml} coincide con los dos tipos de archivo.
Las secciones por tipo de archivo
- Markdown: dos espacios al final de una línea producen un salto de línea, así que se desactiva el recorte para *.md.
- YAML: no se admiten tabuladores para la sangría, así que *.{yml,yaml} se sangra con espacios, dos por nivel.
- Makefile: cada línea de receta debe empezar por un tabulador, así que Makefile recibe indent_style = tab.
Cómo elegir los valores
- Los espacios son la opción habitual para el código. Los tabuladores convienen a un equipo cuyos editores muestran un tabulador con el mismo ancho.
- LF es el salto de línea habitual de los proyectos en Linux y macOS y de la mayoría de los repositorios. CRLF es el salto de línea de los archivos de texto de Windows.
- UTF-8 es la codificación estándar. Use UTF-8 con marca de orden de bytes solo cuando una herramienta la necesite.
Ejemplo resuelto: las opciones por defecto
Con espacios, un tamaño de sangría de 2, LF, UTF-8, los espacios finales eliminados, un salto de línea final y las tres secciones por tipo de archivo, el archivo tiene una línea root, una sección para todos los archivos con seis propiedades, y una propiedad en cada una de las secciones de Markdown y Makefile, más dos en la sección YAML. La tabla enumera once líneas de propiedad, y aquí se muestran seis.
| Sección | Propiedad | Valor |
|---|---|---|
| Inicio del archivo | root | true |
| Todos los archivos | indent_style | space |
| Todos los archivos | indent_size | 2 |
| Markdown (.md) | trim_trailing_whitespace | false |
| YAML (.yml, .yaml) | indent_style | space |
| Makefile | indent_style | tab |
Preguntas frecuentes
¿Dónde debe ir el archivo .editorconfig?
En la carpeta superior del proyecto, junto al README. Los editores lo buscan en la carpeta de cada archivo y después en todas las carpetas superiores, y la búsqueda se detiene en el primer archivo que tiene root = true.
¿Un archivo .editorconfig reformatea mi código?
Por sí mismo, no. Indica a los editores y a los complementos qué sangría, qué saltos de línea y qué codificación usar cuando editan o guardan un archivo. Un formateador o un linter hace el reformateo, y algunos leen los mismos ajustes.
¿Por qué la sección de Markdown mantiene los espacios finales?
En Markdown, dos espacios al final de una línea producen un salto de línea. Quitarlos uniría dos líneas en una, así que esta sección desactiva el recorte solo para los archivos .md.
¿Por qué un Makefile debe usar tabuladores?
make lee cada línea de receta después de un carácter de tabulación, y una receta que empieza por espacios es un error. Por eso la sección de Makefile fija indent_style en tab para los archivos llamados Makefile.
¿Una subcarpeta puede quitar uno de estos ajustes?
Sí, con el valor unset, que elimina una propiedad fijada antes. Esta página escribe solo valores simples, así que añada esa línea en el propio archivo .editorconfig de la subcarpeta si la necesita.
¿Se envía el archivo a algún servidor?
No. El archivo se escribe en su navegador a partir de las opciones que elige, y nada de lo que elige se guarda.
Fuentes
- EditorConfig (en inglés): el formato del archivo y las propiedades admitidas
- Especificación de EditorConfig (en inglés): secciones, patrones y root
- CommonMark 0.31.2 (en inglés): saltos de línea duros (dos espacios al final de una línea)
- YAML 1.2.2 (en inglés): los caracteres de tabulación no deben usarse en la sangría
- Manual de GNU Make (en inglés): una línea de receta empieza por un tabulador
Cifras y texto revisados por última vez el martes, 10 de noviembre de 2026.