ForHosting KIT · Documentos y PDF

Genere una escala tipográfica para encabezados

Parta de un texto de 16 px y una proporción de 1,25, y los encabezados suben por escalones: h6 mide 20, h5 mide 25, h4 mide 31,25 y cada nivel multiplica por la misma proporción. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto

Una escala tipográfica convierte un tamaño de texto base y una proporción en una jerarquía previsible de encabezados. Indique un tamaño base, como 16, y una proporción positiva, como 1.25 para una tercera mayor. El generador asigna potencias sucesivas de esa proporción a los niveles y devuelve una lista ordenada y apta para máquinas desde h1. Resulta útil para crear tokens CSS, documentar un sistema de diseño o comprobar que una jerarquía sigue una regla matemática coherente.

Elija una base y una proporción adecuadas para la lectura

Comience con el tamaño empleado en el texto corrido. Una base de 16 píxeles es habitual en la web, aunque no es una regla universal: una interfaz densa puede usar un valor menor y una publicación editorial puede partir de 18 o 20 píxeles. La proporción determina la rapidez con que los encabezados se alejan de la base.

Un valor de 1.125 produce una progresión discreta, 1.2 ofrece una jerarquía moderada y 1.25 suele denominarse tercera mayor. Las proporciones grandes generan tamaños de exhibición con rapidez, sobre todo al solicitar los seis niveles HTML. La capacidad admite cualquier proporción finita positiva.

Con 1 todos los tamaños son iguales; por debajo de 1, los valores disminuyen al aumentar el exponente. Solo cero y los valores negativos son errores. Mantenga la misma unidad en su sistema.

La respuesta indica px por comodidad, pero la relación numérica no tiene unidad. Decida según el contenido real, la anchura disponible, las métricas de la fuente y los dispositivos de destino, no únicamente por el nombre de la proporción.

Comprenda el cálculo de cada nivel de encabezado

El tamaño base es el paso cero y no se incluye como encabezado. Si solicita seis niveles, h6 recibe la base multiplicada por la proporción elevada a 1, h5 usa el exponente 2 y la secuencia continúa hasta h1 con el exponente 6. Así, cuando la proporción supera 1, h1 queda más alejado del cuerpo, mientras la salida conserva el orden habitual de h1 a h6.

Con tres niveles, la respuesta contiene h1, h2 y h3; h3 usa la primera potencia, h2 la segunda y h1 la tercera. Cada fila presenta el nombre, el exponente y el tamaño calculado. Los valores se redondean a seis decimales para evitar ruido de coma flotante y conservar precisión suficiente para variables CSS.

El campo opcional levels vale 6 por defecto y debe ser un entero entre 1 y 6. Los resultados excesivamente grandes se rechazan antes de producir una salida no finita o inutilizable.

Aplique la escala sin confundir tamaño y estructura

Considere los valores generados como propuestas de diseño, no como una orden para elegir etiquetas según su apariencia. Los niveles HTML expresan la estructura del documento para navegadores, buscadores y tecnologías de asistencia; un h2 debe seguir siendo una subsección de h1 aunque un componente lo represente con un token menor. Un flujo práctico consiste en generar la escala, copiar los tamaños a tokens con nombres semánticos y asignarlos después a elementos estructurales mediante estilos.

Pruebe el mayor valor con títulos reales, pantallas móviles estrechas, traducciones, pesos gruesos y fuentes con métricas distintas. Puede usar solo parte de la escala, limitar los tamaños grandes de forma adaptable o compartir un tamaño entre varios niveles. Estas adaptaciones hacen que la regla funcione bajo restricciones reales.

Para revisiones, conserve juntos la base, la proporción, el número de niveles y las filas devueltas; así quedará claro si un cambio procede del cuerpo, de la proporción o de la selección de niveles.

Crear tokens de diseño CSS

Genere tamaños repetibles para encabezados e incorpore los valores a propiedades personalizadas o a su canal de tokens.

Documentar una jerarquía de marca

Registre la base y la proporción junto a los valores de h1 a h6 para que el equipo reproduzca la tipografía.

Comparar escalas candidatas

Evalúe varias proporciones positivas con la misma base y compare la velocidad de crecimiento de los títulos.

¿Por qué se rechaza una proporción cero?

Cero no puede formar una escala proporcional positiva.

¿La proporción puede ser menor que uno?

Sí. Toda proporción finita positiva es válida. Por debajo de uno, el valor disminuye cuando aumenta el exponente.

¿Cuántos niveles se pueden generar?

Entre 1 y 6, correspondientes a los encabezados HTML estándar. Si se omite levels, el valor predeterminado es 6.

¿Qué proporción conviene usar para empezar?

Una proporción de 1,125 da una progresión contenida, 1,2 una jerarquía visible pero moderada, y 1,25 la clásica tercera mayor. Las proporciones mayores llegan muy rápido a tamaños enormes cuando se piden los seis niveles.

¿Qué escalón de la escala recibe cada encabezado?

El texto base es el escalón cero. El encabezado más pequeño, h6, es la base multiplicada una vez por la proporción, h5 la usa al cuadrado y así hasta h1, que usa la sexta potencia.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/doc/typography-scale-generate

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/doc/typography-scale-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_font_size":16,"ratio":1.25}'
{
  "base_font_size": 16,
  "ratio": 1.25
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.typography_scale_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_mb25
max_pages200
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Comprenda el cálculo de cada nivel de encabezado

El algoritmo no consulta la red, el reloj ni fuentes aleatorias, por lo que una entrada idéntica siempre produce el mismo JSON. Los alias base y font_size designan el tamaño base, y scale_ratio la proporción.

Aplique la escala sin confundir tamaño y estructura

La API cuesta $0.002 por solicitud correcta y el mismo cálculo determinista puede ejecutarse en el navegador. Una entrada inválida, incluida una proporción no positiva, devuelve invalid_input y no una escala parcial.

¿Qué fórmula emplea el generador?

Cada tamaño es base_font_size multiplicado por ratio elevado al exponente indicado en su fila.

¿Cuánto cuesta una solicitud de API?

Una solicitud correcta cuesta $0.002. Las entradas inválidas devuelven un error en lugar de una escala.

Ver la documentación completa del KIT →