v0.3.19

El Tipógrafo Programable para la Web

Postext parte de markdown semántico y aplica reglas de maquetación con siglos de historia — justificación Knuth-Plass, prevención de huérfanas, colocación de figuras — para generar páginas con calidad editorial renderizadas a HTML, canvas o PDF listo para imprenta.

EmpezarVer en GitHub

Qué Es Postext

Maquetación Editorial,
Computada para la Web

CSS ofrece maquetación responsiva — flexbox, grid, columnas. Pero no sabe balancear columnas, evitar huérfanas, ajustar texto alrededor de figuras ni colocar notas al pie en la base de una columna. Son decisiones editoriales depuradas durante siglos de tipografía impresa.

Postext cubre ese vacío. Pásale markdown semántico y un objeto de configuración. Mide texto entre 300 y 600 veces más rápido que el DOM gracias a @chenglou/pretext, calcula la geometría completa de cada página — cada línea, flotante y pie de figura — y la renderiza mediante los backends de HTML, canvas o PDF listo para imprenta.

Entrada

# Chapter One

The quick brown fox jumps over
the lazy dog. A paragraph with
a {{figure:hero-img}} reference
and a footnote.[^1]

[^1]: Additional context placed
at column bottom automatically.

Salida

Capacidades

Lo que los Tipógrafos Siempre Han Sabido

Justificación Knuth-Plass

El mismo algoritmo óptimo de partición de líneas que usa TeX, con separación silábica por patrones de TeX y control de huérfanas — bloques de texto homogéneos sin ríos de blanco, más allá de lo que CSS puede expresar.

Recursos y Referencias Cruzadas

Figuras, diagramas SVG y tablas que flotan al inicio o al final de columnas y páginas — como los flotantes en imprenta — con numeración tipada y referencias :ref que siempre se mantienen sincronizadas.

Estilo de Tablas y Pies de Figura

Tablas compuestas con tipografía independiente para cuerpo y cabecera, y pies de figura que siguen tu configuración — numerados, con estilo propio y colocados junto al recurso que describen.

Diagramas a una Tinta

Recolorea los diagramas SVG a matices de una sola tinta según su luminancia, para que cada ilustración encaje con tu diseño — listos para impresión con tinta directa.

Matemáticas en LaTeX

Ecuaciones en línea y en bloque escritas en LaTeX, medidas y compuestas por el motor para que se asienten en la retícula base junto al texto.

Web y PDF Listo para Imprenta

Un motor de maquetación, tres renderizadores. Las mismas páginas calculadas se renderizan a HTML, canvas o PDF listo para imprenta — con marcadores y color CMYK.

API

Una Función, Control Total

Llama a buildDocument con tu contenido y un objeto de configuración. Recibes la geometría completa de las páginas, lista para renderizar con renderToHtml — o con los backends de canvas y PDF.

import { buildDocument, renderToHtml } from "postext";

const doc = buildDocument(
  { markdown },
  {
    layout: { layoutType: "double" },
    bodyText: {
      textAlign: "justify",
      hyphenation: { enabled: true, locale: "en-us" },
    },
  }
);

const html = renderToHtml(doc);

Flujo de Trabajo

Maquetación Editorial en Tres Pasos

  1. Escribe Markdown Semántico

    Escribe tu contenido en markdown enriquecido con referencias a recursos y marcadores de notas al pie. Sin pensar en maquetación — solo contenido.

  2. Configura las Reglas de Maquetación

    Define columnas, reglas tipográficas, estrategias de colocación de recursos y ajustes por sección en un objeto PostextConfig.

  3. Renderiza a HTML, Canvas o PDF

    Llama a buildDocument y obtén la geometría completa de la maquetación — y renderízala con el backend de HTML, canvas o PDF listo para imprenta.

Instalación

Empieza en Menos de un Minuto

# Instala con tu gestor de paquetes
pnpm add postext
// Inicio rápido
import { buildDocument, renderToHtml } from "postext";

const doc = buildDocument({
  markdown: "# Hello World\n\nYour content here.",
});

const html = renderToHtml(doc);