PDF Restyle: re-maquetar cualquier PDF con tu estilo y tu voz

Un plugin de Claude Code que toma un PDF, lo entiende, lo traduce al español y lo vuelve a maquetar con el estilo visual y la voz que elijas, conservando las imágenes originales sin pérdida y sin tocar un solo dato.

La voz cambia la envoltura, no el dato.

PDF Restyle es un plugin de Claude Code que toma un PDF, lo entiende, lo traduce al español y lo vuelve a maquetar con el estilo visual y la voz que elijas. Nació de algo cotidiano: guías, manuales y recetarios que llegan en otro idioma, mal diagramados o pensados para imprimir, y que al final alguien termina leyendo en el celular.

Lo hice para compartirlo con amigos y lo publiqué como código abierto con licencia MIT.

Qué hace

Lee el texto y también las miniaturas de cada página, así reconoce qué es título, qué es paso y qué imagen va con qué sección. Traduce si hace falta, aplica una voz y vuelve a maquetar con los tokens de un archivo de estilo. Además agrega el aparato editorial que casi nunca trae el original: portada, tabla de contenido con números de página reales, folios, cornisas, aperturas de sección y créditos.

Hay cosas que el plugin nunca hace. Las cantidades, medidas, tiempos, materiales, advertencias de seguridad, marcas y el orden de los pasos quedan bloqueados, y al terminar se verifica que sigan ahí. Si «12 tallos» se volvió «unos cuantos tallos», se reporta como error. Tampoco retoca imágenes ni inventa información que no estuviera en el original.

Se lee en el celular

Casi todos estos PDF se terminan leyendo en un teléfono, así que el plugin pregunta el destino antes que nada y de ahí deriva el formato. El dato que lo decide es simple: en el celular, el visor ajusta el ancho de la página al de la pantalla, así que el tamaño aparente del texto depende del cuerpo dividido por el ancho de página.

Subir el tamaño de letra en A4 no arregla nada: haría falta un cuerpo de 23 pt. El formato de página es la palanca. Por eso cada estilo tiene su variante para celular en vertical 9:16.

Estilos y voces

Hay quince estilos: ocho editoriales con carácter propio y siete pensados para manuales. Doce tienen variante para celular. Las voces son cuatro, amigable, neutra, editorial e institucional, cada una con el tratamiento que elijas: tú, usted o impersonal.

Un estilo es un archivo markdown legible, con un bloque CSS que se inyecta tal cual y unas reglas en prosa que el modelo lee al diagramar, para decidir lo que el CSS no puede expresar.

# Editorial cálido

**Cuándo usarlo:** contenido narrativo con fotografía.
**Voz sugerida:** amigable-cercano

```css
:root {
  --font-display: 'Fraunces', Georgia, serif;
  --bg: #FBF7F0; --ink: #1F1B16; --accent: #0F3D2E;
  --margin-v: 24mm; --img-ratio: 4/5;
}
```

## Reglas propias
- Portada con imagen a sangre, título sobreimpreso abajo
- Aperturas de sección en página impar

Se pueden sumar estilos de tres formas: elegir uno de la biblioteca, pedir que se propongan según el contenido del PDF o pasar una referencia, como la foto de una revista o un PDF que te gustó, para extraer sus tokens.

Cómo funciona por dentro

PDF ──► extraer ──► entender ──► entrevista ──► voz ──► paginar ──► render ──► QA

Tres decisiones definen la arquitectura, y las tres salieron de probar antes de decidir:

• —No edita el PDF, lo reconstruye. Manipular flujos de contenido y fuentes embebidas es frágil; extraer y rehacer desde HTML y CSS de impresión da control total. El PDF original es materia prima, no lienzo.
• —Chrome es el motor de render porque no recomprime imágenes. Un JPEG que entra sale con el mismo hash, así que las fotos viajan byte a byte al PDF nuevo.
• —Pagina el plugin, no el navegador. Chrome ignora las cajas de margen de CSS para medios paginados, así que los folios por @page no funcionan. Cada página es un contenedor de alto fijo que construye el plugin, y por eso sabe en qué página cae cada sección y puede armar la tabla de contenido con números reales, en dos pasadas.

Lo que aprendí

Que la pregunta correcta no era qué estilo quiere la persona, sino dónde va a leer. Esa pregunta cambió el formato por defecto de todo el plugin.

También que las reglas duras son las que dan libertad. Como los datos quedan bloqueados y se verifican al final, el modelo puede ser atrevido con la voz y la diagramación sin poner en riesgo lo que importa. Y que vale la pena verificar las suposiciones sobre las herramientas antes de diseñar alrededor de ellas: tres comportamientos de Chrome definieron la arquitectura entera.