CSS Styles para templates
Cómo personalizar visualmente la salida final sin romper legibilidad ni exportación.
Para qué sirve
El campo CSS Styles permite personalizar la apariencia del documento final (especialmente en exportación PDF): tipografías, portada, tablas, espaciados, bloques de código y colores.
Recomendaciones de estilo
- Prioriza legibilidad: contraste alto y tamaños de fuente razonables.
- Define estilos globales suaves para
h1,h2,p,table,code. - Mantén márgenes y saltos de página pensados para impresión.
- Reutiliza clases semánticas (por ejemplo
.doc-cover) para portada y secciones especiales.
Ejemplo de áreas a estilizar
- Portada: título, subtítulo, logo.
- Encabezados: escala tipográfica consistente.
- Tablas: bordes suaves y padding suficiente.
- Código: fondo tenue, fuente monoespaciada, wrap controlado.
Buenas prácticas
- Evita reglas extremadamente específicas que dependan de una estructura frágil.
- Prueba con contenido largo (muchos endpoints) para validar saltos de página.
- Si compartes el template, documenta cualquier clase CSS personalizada relevante.
Errores comunes
- Usar tamaños de fuente muy pequeños para PDF.
- Aplicar colores con poco contraste.
- Agregar demasiadas reglas que vuelven difícil el mantenimiento del template.
Relacionado: Template Markdown: estructura y placeholders, Branding de organización.