Importar un sitio con Tailwind a Figma sin perder la escala de espaciado
De Tailwind a Figma sin perder la escala de espaciado: lee la unidad base, convierte rem a px y reconstruye los pasos como variables numéricas de Figma.
Introducción
Cuando llevas un sitio con Tailwind a Figma, los valores de espaciado llegan como números simples, pero la escala que hay detrás no llega. Para conservarla, anota la unidad base del sitio, convierte rem a px una sola vez y reconstruye los pasos como variables numéricas de Figma. Este tutorial sigue ese orden. Necesitas el CSS del sitio abierto y un archivo de Figma con la página importada, por ejemplo una traída con UnHTML.
El objetivo es modesto. Las capas de Figma guardan valores numéricos de padding y gap, no nombres de clase como p-4. Una importación lee la página ya renderizada, así que el número está ahí y el nombre se ha perdido. Los pasos siguientes devuelven los nombres.
Cómo construye Tailwind v4 su escala de espaciado
Una variable, muchas utilidades
En octubre de 2026, la documentación de Tailwind v4 lista --spacing: 0.25rem entre sus variables de tema por defecto. Cada paso de espaciado es un múltiplo de ese único valor. La referencia de padding muestra la forma compilada: p-<number> se convierte en padding: calc(var(--spacing) * <number>). Así, p-4 es 4 veces 0.25rem, es decir, 1rem.
Por eso la escala se siente regular. El paso 1 es 0.25rem, el paso 2 es 0.5rem y cada salto entre pasos tiene el mismo tamaño.
Qué utilidades la comparten
El espacio de nombres --spacing-* cubre más que el padding. La documentación del tema lo describe como el origen de las utilidades de espaciado y tamaño como px-4 y max-h-16. El ancho, el alto, el margen y el gap salen de los mismos pasos. Cuando lees un frame importado, un gap de 64px y un alto de 64px pueden venir del mismo paso 16.
Sitios que cambian la base
Un sitio puede redefinir la unidad base dentro de @theme. La documentación de Tailwind muestra ejemplos como --spacing: 4px y --spacing: 1px. Si un sitio fija otra base, todos los pasos cambian con ella y la suposición de 4px deja de valer. No conviertas los valores importados hasta haber revisado el tema de origen.
rem frente a px: qué significan los números tras la importación
Tailwind escribe su escala en rem. MDN define rem como relativo al font-size del elemento raíz, normalmente html. También señala que 16px es un valor habitual por defecto en los navegadores, pero las preferencias del usuario pueden cambiarlo. Figma trabaja en px, así que la conversión ocurre en algún punto entre el navegador y tu archivo.
Con una raíz de 16px, los pasos más comunes quedan así:
| Paso de Tailwind | Valor en rem | Valor en px |
|---|---|---|
| 1 | 0.25rem | 4px |
| 2 | 0.5rem | 8px |
| 3 | 0.75rem | 12px |
| 4 | 1rem | 16px |
| 6 | 1.5rem | 24px |
| 8 | 2rem | 32px |
| 16 | 4rem | 64px |
Si el sitio define html { font-size: 62.5%; } o cualquier otro tamaño de raíz, esta tabla no sirve para ese sitio. Abre el CSS, busca el tamaño de fuente raíz y rehaz la multiplicación. Un solo número decide si todos los paddings del archivo se leen bien.
Revisa el tema de origen antes de importar
Haz esto antes de tocar Figma. Cinco minutos aquí ahorran un día de variables equivocadas.
- Abre la hoja de estilos principal del sitio, o el código de su archivo de entrada de Tailwind.
- Busca
@theme. Anota cualquier línea--spacingo--spacing-*y su valor. - Busca un
font-sizeraíz enhtmlo:root. - Anota la unidad base en px. Para el tema por defecto con raíz de 16px, son 4px.
- Anota los tokens con nombre, como un
--spacing-18personalizado, con su valor en px.
Un sitio con una versión anterior de Tailwind guarda su escala en otro lugar, normalmente un archivo de configuración. No adivines qué versión estás viendo. Lee el CSS real y confía en los números que contiene.
Convierte la escala en una colección de variables de Figma
Las variables de Figma son el lugar adecuado para una escala de espaciado. La guía de variables de Figma explica que las variables viven en colecciones y que los modos permiten que una variable tenga varios valores. Una colección de espaciado puede empezar con un solo modo y sumar otros después, por ejemplo una densidad compacta y otra amplia.
Esta es la secuencia:
- Crea una colección llamada Spacing.
- Añade variables numéricas con el nombre del paso:
space/1,space/2,space/4, y así sucesivamente. - Asigna cada valor desde tu tabla:
space/1vale 4,space/4vale 16,space/16vale 64. - Añade los tokens personalizados que encontraste en el tema, cada uno con su valor en px.
- Selecciona los frames importados y aplica las variables al padding y al gap del auto layout.
Para asociar los valores importados con un paso, divide el valor en px entre tu unidad base. Un padding de 24px dividido entre 4 es el paso 6. Un gap de 20px dividido entre 4 es el paso 5, que no aparece en la tabla pero sigue dentro de la escala.
Si prefieres no teclear los números, existe una vía de terceros. El plugin de la comunidad CSS Variables indica compatibilidad con longitudes en px, in, cm, mm, pt, pc y rem, y convierte rem con una base de 16px. No es una función integrada de Figma y ignora las variables que no son de color ni de longitud. Pruébalo primero con un archivo pequeño y confirma que la colección aparece de verdad. Para ver mejor cómo las variables hacen que una página se adapte, consulta cómo hacer responsive una página importada con variables de Figma.
Un ejemplo práctico: leer una tarjeta
Supón que importas una página de precios y seleccionas una tarjeta. Figma muestra 24px de padding en los cuatro lados, un gap de 16px entre el título y el texto, y un gap de 32px entre la tarjeta y la siguiente.
Con una base de 4px, la aritmética es corta. El padding de 24px es el paso 6 (24 entre 4). El gap de 16px es el paso 4. El gap de 32px entre tarjetas es el paso 8. En términos de Tailwind, esa tarjeta probablemente se escribió como p-6, con gap-4 por dentro y gap-8 por fuera, aunque la importación no puede decirte las clases originales, solo los valores.
Ahora vincúlalos. Selecciona la tarjeta, abre los campos de padding en el panel de auto layout y asocia space/6. Asocia space/4 al gap interno y space/8 al externo. Repite con la siguiente tarjeta y volverás a encontrar los mismos tres números. Esa repetición es la escala mostrándose, y es la comprobación más rápida de que tu unidad base es correcta. Si los números no se repiten, o se dividen en fracciones raras, vuelve al paso del tema y busca un --spacing sobrescrito o un tamaño de fuente raíz poco habitual.
Cómo tratar los valores fuera de la escala
No todos los números caerán en un paso. Las clases de utilidad admiten valores arbitrarios como p-[13px], y a veces los componentes llevan tamaños fijos que nunca pasaron por la escala. Trátalos como hallazgos, no como errores.
No los ajustes en silencio. Redondear un padding de 13px a 12px cambia el diseño en un píxel y oculta que el autor original rompió el sistema. Conserva el valor original, marca el frame y decide más tarde si el diseño debe adoptar un paso o mantener la excepción.
Revisa también el informe de importación en busca de lo que haya recurrido a una alternativa, como una posición absoluta donde esperabas auto layout. Una importación es fiel y editable, no un clon exacto al píxel, así que algunos valores necesitarán una revisión manual. Corrígelos en el archivo en lugar de suponer que la escala se aplica en todas partes.
Conclusión
Conservar una escala de espaciado de Tailwind en Figma se reduce a tres movimientos. Lee la unidad base y el tamaño de fuente raíz del CSS real. Convierte rem a px una sola vez, con una tabla en la que confíes. Después reconstruye los pasos como una colección de variables numéricas y aplícala al padding y al gap. La importación aporta los números; las variables aportan los nombres. Cuando quieras ir más lejos, crear un sistema de diseño a partir de un sitio importado cubre la siguiente capa: estilos, componentes y entrega.