Saltar al contenido principal
Receta número 61

Recetario · Capítulo 2 · Texto y tipografía

Formato de guion cinematográfico

Guion de rodaje en Courier Prime 12 sobre papel carta, con las réplicas en recuadros sin borde del ancho del diálogo y las escenas numeradas en ambos márgenes.

En esta página
Salida
Canvas
Postext
Probada con Postext 1.65.0
Requiere ≥ 1.25.0
Licencia
Actualizada el 11 oct 2026
Código MIT · Texto CC BY 4.0

pp. 2–1 · 2–3 de 5

  • Formato 215,9 × 279,4 mm
  • 1 columna
  • Courier Prime 12/12
  • Oswald
  • Special Elite
  • 5 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 53 ms
  • 149 líneas de código

En pocas palabras

El guion de un cortometraje con el formato que usan los estudios de cine. Lleva una letra de máquina de escribir, y los diálogos y los números de escena van a distancias fijas del borde.

Lo que vas a componer

La versión de rodaje de Objetos perdidos, un cortometraje inventado de tres páginas, encuadernada como los guiones de los estudios: cubierta de cartulina mostaza con dos encuadernadores de latón y etiqueta mecanografiada, el interior sellado con COPIA 07 y, detrás, el guion en Courier Prime de 12 sobre 12 en papel carta taladrado. Las medidas son las de los programas de guion: acción de 1,5 a 7,5 pulgadas; réplica de 2,5 a 6, bajo el nombre del personaje a 3,7; acotación desde 3,1, y CORTE A: y FUNDIDO A NEGRO. hasta el margen derecho. Cada escena lleva su número en los dos márgenes. La página 1 del guion no lleva número; las demás, arriba a la derecha y con punto. Cada réplica es un recuadro sin borde, con el nombre del personaje en el mismo interlineado de 12 pt que el texto, y así acción y diálogo mantienen seis líneas por pulgada.

Esta receta responde a

  • ¿Cómo compongo un guion de cine o una obra de teatro: encabezados de escena, nombres de personaje y diálogo sangrado por los dos lados?

La respuesta corta

script.js · líneas 43–64en el código completo
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
  id: 'dialogue',
  backgroundEnabled: false, // no fill and no border: the box is only a measure
  padding: { top: pt(0), bottom: pt(0),
    left: mm((DIALOGUE.left - MARGIN.left) * IN), // 1 inch in from the action
    right: mm((TEXT_RIGHT - DIALOGUE.right) * IN) }, // 1.5 inches short of it
  // The fence's title is the cue: title="Dora (cont’d)" prints DORA (CONT’D) at 3.7 inches,
  // in the headings' Courier, with no gap under it (the default is half a line). On the
  // body's 12-pt leading (the default is 1.2 times its size, 14.4 pt), the name sits on a
  // grid line and a speech is a whole number of lines.
  titleStyle: { fontWeight: 400, textTransform: 'uppercase', lineHeight: pt(LEAD),
    indent: mm((CUE - DIALOGUE.left) * IN), gap: pt(0) },
  body: { paragraphSpacing: false }, // no blank line before a parenthetical mid-speech
  marginTop: pt(LEAD), marginBottom: pt(LEAD), // one blank line above and below
  // Snapped to the grid, a box keeps its bottom margin and the next speech adds its top
  // margin: two blank lines between speeches. Unsnapped, the two margins collapse into one.
  snapToGrid: false,
};

Ingredientes

Tipografía
Courier Prime, Oswald (SIL OFL 1.1) · Special Elite (Apache 2.0)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

El código está en la respuesta corta, más arriba. El relleno de un recuadro se mide desde la caja de texto, así que 1 pulgada a la izquierda y 1,5 a la derecha dejan el bloque de 3,5 pulgadas que empieza a 2,5 del borde de la hoja (estilos de recuadro). El nombre del personaje es el título del recuadro y se escribe en la línea de apertura: title="Dora (cont.)". textTransform lo pasa a mayúsculas, e indent lo lleva 1,2 pulgadas más allá del relleno, hasta 3,7. gap vale 0 porque, por defecto, entre el nombre y la réplica queda medio cuadratín, 6 pt. Por defecto el título de un recuadro se compone en una línea de 1,2 veces su cuerpo, 14,4 pt aquí. titleStyle.lineHeight lo pone en los 12 pt del texto, así que el nombre cae en una línea de la rejilla y la réplica ocupa un número entero de líneas de 12 pt; con el valor por defecto, cada réplica alejaría 2,4 pt más de la rejilla el texto que la sigue. Con snapToGrid desactivado, el margen inferior de una réplica y el superior de la siguiente se funden en una sola línea en blanco. Un recuadro se mantiene entero por defecto, de modo que una réplica que ya no cabe pasa a la página siguiente con su nombre.

#2 · Mide la página en pulgadas

script.js · líneas 33–39en el código completo
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
  margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
    left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
  textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
  paragraphSpacing: true }; // a blank line between paragraphs

Tamaño carta, con el margen izquierdo de 1,5 pulgadas por el que pasan los encuadernadores y una pulgada en los otros tres lados. Courier Prime es una letra monoespaciada: a 12 pt cada carácter mide una décima de pulgada, así que una línea de acción admite 60 caracteres y una de diálogo 35, y con un interlineado de 12 pt caben 54 líneas en la página. El texto va en bandera, alineado a la izquierda, y paragraphSpacing deja una línea en blanco entre párrafos. El texto en bandera solo lleva separación silábica si la pide bodyText.hyphenation.ragged, así que ninguna palabra se corta, como pide el formato.

#3 · Haz de las acotaciones y las transiciones estilos de párrafo

script.js · líneas 68–72en el código completo
const PAREN = 3.1;
const paragraphStyles = [
  { id: 'paren', firstLineIndent: mm((PAREN - DIALOGUE.left) * IN) }, // inside a speech
  { id: 'transition', textAlign: 'right' }, // CUT TO:, flush with the action's right edge
];

Un contenedor :::paragraphs{style="paren"} dentro de una réplica sangra su primera línea 0,6 pulgadas desde el borde del diálogo, hasta 3,1 (estilos de párrafo). Escribe cada acotación en una sola línea, porque el estilo solo sangra la primera. En el estilo del diálogo, body.paragraphSpacing: false deja fuera del recuadro la línea en blanco que separa los párrafos de acción, y (luego) queda justo debajo de la línea anterior. CORTE A: y FUNDIDO A NEGRO. van en contenedores transition, cuyo textAlign: 'right' los alinea con el final de las líneas de acción. Un contenedor devuelve el texto a la rejilla base después de su último párrafo; este guion no sale nunca de ella, así que el encabezado que sigue a CORTE A: conserva sus dos líneas en blanco.

#4 · Cuelga los números de escena en los dos márgenes

script.js · líneas 76–105en el código completo
// Each number sits in a box half an inch wide, text aligned left, so that 9, 12 and an
// inserted 12A start at the same place on both sides.
const NUMBER_W = 0.5; // inches
const number = (id, edge, x) => ({ kind: 'text', id, content: '{number}', fontFamily: TEXT,
  fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
  placement: { ...at('container', edge, x * IN), size: { width: mm(NUMBER_W * IN) } } });
// The heading's own text is not painted but still measured: at the level's default 15 pt,
// scene 1's heading would wrap and reserve a second line.
const slugline = { level: 2, fontSize: pt(12), lineHeight: pt(LEAD),
  marginTop: pt(2 * LEAD), marginBottom: pt(LEAD), // two blank lines above, one below
  numberingTemplate: '{2}', // the scene count, which {number} prints
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'heading', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
      fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
      placement: { ...at('container', 'top-left'), size: { width: 'fill' } } },
    number('left', 'top-left', -0.6), // starts at 0.9 inches from the edge of the sheet
    number('right', 'top-right', 0.25 + NUMBER_W), // starts a quarter inch past the text
  ] } } };
const headings = {
  // The family of the speech titles, and the one the headings' unpainted text is measured
  // in (left unset, a sixth face, Open Sans Bold, would be loaded for nothing).
  fontFamily: TEXT,
  // Script pages end where the last whole speech or paragraph ends. Balancing would add
  // blank lines above the sluglines to fill them.
  balancing: { enabled: false },
  levels: [
    // 'any': the cover, its inside and the title each open the next page, with no blank.
    { level: 1, breakBefore: { enabled: true, parity: 'any' } },
    slugline,
  ] };

numberingTemplate: '{2}' cuenta los encabezados de nivel 2, y {number} imprime esa cuenta en el diseño (configuración por nivel). Un título con diseño avanzado conserva su sitio en la columna y dibuja sus elementos en lugar de su texto (apertura a toda página y diseño avanzado), y así los dos números pueden quedarse en los márgenes, junto al encabezado en negrita. Cada uno se ancla a la caja del propio título y sale de ella: 0,6 pulgadas a la izquierda y, a la derecha, un cuarto de pulgada más allá del final del texto, en una caja de media pulgada con el texto alineado a la izquierda, para que en un guion de más de nueve escenas los números de una y de dos cifras empiecen en el mismo sitio. El texto propio del título no se pinta, pero se mide, y por eso el nivel va a 12 pt: con los 15 pt por defecto, el encabezado de la escena 1 pasaría a dos líneas y reservaría la segunda. El equilibrado de columnas está desactivado: añadiría líneas en blanco sobre los encabezados de escena para llenar una página corta, y una página de guion acaba donde acaba su última réplica o su último párrafo.

#5 · Taladra y numera solo las páginas del guion

script.js · líneas 109–129en el código completo
// Three holes down the bound edge, 4.25 inches apart, as a three-hole punch leaves them.
const HOLES = [1.25, 5.5, 9.75].map((y) => y * IN); // mm: hole centres from the top
const EDGE = 0.375 * IN; // mm: from the bound edge to the centre of each hole
const HOLE = 7; // mm across
const punched = HOLES.map((y, i) => ({ kind: 'box', id: `punch${i}`,
  style: { backgroundColor: col('hole'), borderRadius: mm(HOLE / 2) },
  placement: { ...at('page', 'top-left', EDGE - HOLE / 2, y - HOLE / 2),
    size: { width: mm(HOLE), height: mm(HOLE) } } }));
// The script's first page opens with its title, an H1 that breaks the page, so the page is
// an 'opener' and pages: 'body' leaves it unnumbered, as the format asks.
const folio = { kind: 'text', id: 'folio', content: '{pageNumber}.', pages: 'body',
  fontFamily: TEXT, fontSize: pt(12), color: col('ink'), align: 'right',
  placement: at('page', 'top-right', -MARGIN.right * IN, 0.5 * IN) };
// The title's style carries the header of its section: the pages from the title to the end.
const title = { id: 'script', header: { elements: [...punched, folio] },
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: TEXT, fontSize: pt(12),
      lineHeight: 1, textTransform: 'uppercase', color: col('ink'), align: 'center',
      placement: { ...at('container', 'top'), size: { width: 'fill' } } },
  ] } }, // H1's own line, 1.2 × 18 pt, would reserve 21.6 pt and drop FADE IN: 9.6 pt
  lineHeight: pt(LEAD), marginBottom: pt(LEAD) };

El estilo del encabezado del guion lleva su propia cabecera (header), que sustituye a la del documento en las páginas de su sección, del título al final (estilos de encabezado). La cabecera del documento está vacía, así que los agujeros y el número de página solo salen en el guion. El número se ancla a media pulgada del borde superior de la hoja, y pages: 'body' lo deja fuera de las páginas de apertura (elementos de texto). El título del guion es de nivel 1 y abre página, así que la página 1 cuenta como página de apertura y no lleva número, como pide el formato. Las cubiertas también son encabezados de nivel 1; :::numbering{startAt=1}, entre el interior de la cubierta y el título, da el número 1 a la página del título, y la siguiente lleva el 2. El estilo del encabezado fija una línea de 12 pt; con los 18 pt propios del nivel 1, el título iría en una línea de 21,6 pt y bajaría FUNDIDO DE ENTRADA: 9,6 pt.

La receta completa

Sandbox
// ═══ Postext Cookbook · Nº 061 · Screenplay format ═══════════════════════════════
// https://postext.dev/en/cookbook/screenplay-format
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Courier Prime, Oswald (SIL OFL 1.1), Special Elite (Apache 2.0) · Needs postext ≥ 1.25.0
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'screenplay-format';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { // black type on white bond, and a card cover in goldenrod
  ink: '#1b1b1b', // every line of the script
  paper: '#ffffff',
  hole: '#e3e1db', // the punched holes down the left edge of each script page
  card: '#e6b84a', // the cover stock
  cardDark: '#b98a2a', // the label's shadow and the rims of the punched holes
  cardInk: '#4a3510', // the small print on the cover (6.3:1 on the card)
  brass: '#a8812f', // the brads
  brassLight: '#e9cf82', // the glint on each brad
  stamp: '#8f231c', // the draft stamp (4.7:1 on the card)
};
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to main-color: pointed at the ink, anything left unset prints black.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const TEXT = 'Courier Prime';
const IN = 25.4; // mm in an inch: the format is specified in inches
const LEAD = 12; // pt: 12-point Courier at six lines to the inch, so one line is one grid line
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });

// #region page: US Letter, a 1.5-inch binding margin, Courier 12 on 12, ragged right
const MARGIN = { top: 1, bottom: 1, left: 1.5, right: 1 }; // inches: the left one takes the brads
const page = { sizePreset: 'custom', width: mm(8.5 * IN), height: mm(11 * IN), dpi: 150,
  margins: { top: mm(MARGIN.top * IN), bottom: mm(MARGIN.bottom * IN),
    left: mm(MARGIN.left * IN), right: mm(MARGIN.right * IN) } };
const bodyText = { fontFamily: TEXT, fontSize: pt(12), lineHeight: pt(LEAD), color: col('ink'),
  textAlign: 'left', firstLineIndent: pt(0), // action: flush left, never justified
  paragraphSpacing: true }; // a blank line between paragraphs
// #endregion

// #region answer: a speech is a callout with no frame, padded to the 3.5-inch dialogue block
// Positions from the left edge of the sheet, in inches, as screenwriting software gives them.
const DIALOGUE = { left: 2.5, right: 6 }; // the block of speech, 3.5 inches wide
const CUE = 3.7; // the character's name
const TEXT_RIGHT = 8.5 - MARGIN.right; // 7.5: where action lines end
const dialogue = {
  id: 'dialogue',

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Devuelve las réplicas a la rejilla

Cada réplica conserva entonces su margen inferior y la siguiente le suma el superior, lo que deja dos líneas en blanco entre réplicas (tres antes de un encabezado de escena) y lleva el guion a una cuarta página.

-  snapToGrid: false,
 };

#Escribe los encabezados de escena sin negrita

A máquina, los encabezados de escena se escribían solo en mayúsculas; la negrita llegó con los programas de guion.

-  fontSize: pt(12), fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left',
+  fontSize: pt(12), fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left',
-      fontWeight: 700, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',
+      fontWeight: 400, lineHeight: 1, color: col('ink'), align: 'left', overflow: 'wrap',

Errores frecuentes

  • Postext no imprime (MÁS) bajo una réplica que se parte entre dos páginas ni repite el nombre sobre el resto. Deja keepTogether con su valor por defecto para que cada réplica pase entera a la página siguiente.
  • Los programas de guion añaden (CONT.) al nombre automáticamente. Aquí va en el title de la línea de apertura, así que escríbelo tú donde un personaje sigue hablando después de una acción.
  • titleStyle.lineHeight mantiene la réplica en la rejilla solo mientras sea igual al interlineado del texto. Un nombre en un cuerpo mayor o menor sigue necesitando esos 12 pt; si no, cada réplica saca de la rejilla las líneas que la siguen.

Créditos

Texto
Texto original, CC BY 4.0
Fuentes
Courier Prime (SIL OFL 1.1) · Special Elite (Apache 2.0) · Oswald (SIL OFL 1.1)
Sandbox