Vim: Plegado de código (folding)

El folding permite colapsar regiones de texto para reducir el ruido visual y navegar archivos grandes con más claridad. Vim ofrece seis métodos de plegado adaptables a cualquier flujo de trabajo.

---

Abreviaciones de modos:
N = Normal | I = Insert | V = Visual | C = Command | VB = Visual Block

Comandos básicos de fold

Modo	Comando	Acción
N	zo	Abre el fold bajo el cursor
N	zc	Cierra el fold bajo el cursor
N	za	Alterna el fold bajo el cursor (open/close)
N	zO	Abre el fold y todos sus anidados recursivamente
N	zC	Cierra el fold y todos sus anidados recursivamente
N	zA	Alterna el fold recursivamente
N	zr	Reduce el foldlevel global en 1 (abre un nivel)
N	zR	Abre todos los folds del archivo
N	zm	Aumenta el foldlevel global en 1 (cierra un nivel)
N	zM	Cierra todos los folds del archivo

---

Navegar entre folds

Modo	Comando	Acción
N	zj	Salta al inicio del siguiente fold
N	zk	Salta al final del fold anterior
N	[z	Salta al inicio del fold actual
N	]z	Salta al final del fold actual

---

Crear y eliminar folds manuales

Modo	Comando	Acción
N	zf{motion}	Crea un fold manual sobre el movimiento
V	zf	Crea un fold manual sobre la selección
N	zd	Elimina el fold bajo el cursor
N	zD	Elimina el fold y sus anidados recursivamente
N	zE	Elimina todos los folds manuales del archivo
C	:{n},{m}fold	Crea un fold manual entre las líneas n y m

---

Métodos de folding (foldmethod)

Método	Descripción
manual	Folds creados manualmente con zf
indent	Pliega según el nivel de indentación
syntax	Pliega según la sintaxis del lenguaje
expr	Pliega según una expresión Vimscript personalizada
marker	Pliega entre marcadores {{{ y }}} en el texto
diff	Pliega las zonas sin cambios en modo diff

---

Configurar el método de folding

Modo	Comando	Acción
C	:set foldmethod=indent	Activa folding por indentación
C	:set foldmethod=syntax	Activa folding por sintaxis
C	:set foldmethod=marker	Activa folding por marcadores
C	:set foldlevel=1	Muestra solo el primer nivel de folds al abrir
C	:set foldlevel=99	Abre todos los folds por defecto
C	:set foldcolumn=2	Muestra una columna visual indicando folds
C	:set foldenable	Activa el folding
C	:set nofoldenable	Desactiva el folding sin eliminar los folds

---

Folding con marcadores

Modo	Comando	Acción
N	zf con foldmethod=marker	Inserta {{{ y }}} automáticamente
C	:set foldmarker={{{,}}}	Define los marcadores de apertura y cierre
C	:set foldmarker=<!--,-->	Usa marcadores HTML como delimitadores

Ejemplo de marcadores en código:

// Sección de configuración {{{
const config = { ... }
// }}}

---

Persistir folds entre sesiones

Modo	Comando	Acción
C	:mkview	Guarda los folds y la vista del buffer actual
C	:loadview	Restaura los folds guardados con :mkview
C	:set viewoptions=folds	Limita lo que guarda :mkview solo a folds

Para persistir automáticamente en vimrc:

autocmd BufWinLeave * mkview
autocmd BufWinEnter * silent! loadview

---

Tips

• foldmethod=indent es el más inmediato en Python y lenguajes donde la indentación es estructura: funciona sin configuración adicional.
• zR y zM son los comandos de orientación rápida: abre todo para ver el mapa completo, cierra todo para ver solo la estructura.
• nofoldenable desactiva el folding temporalmente sin perder los folds definidos; foldenable los restaura tal como estaban.
• Los marcadores {{{ y }}} permiten anotar secciones lógicas en archivos de configuración o Vimscript con control total sobre los límites.
• :mkview y :loadview en autocmds es la forma más simple de persistir folds sin plugins; guarda también la posición del cursor y el scroll.