Cómo crear un Pandoc reference.docx: de Markdown a Word con marca
Markdown te da una fuente de verdad limpia, pero tarde o temprano alguien pide un archivo Word que parezca hecho de verdad por tu empresa: fuentes corporativas, títulos con la marca, márgenes coherentes. Pandoc lo resuelve con un único archivo llamado reference docx. Cada estilo del documento exportado — títulos, cuerpo de texto, tablas, notas al pie — se hereda de ese archivo, así que construir uno bueno es la diferencia entre un volcado genérico y un documento listo para entregar.
Este artículo explica cómo funciona un reference docx, cómo producir uno, qué estilos merecen tu atención y cómo probar el resultado sin dar vueltas. Las ideas sirven tanto si conviertes en la línea de comandos como en el navegador — y un reference docx terminado se conecta directamente al flag --reference-doc de Pandoc.
Por qué el reference docx lo decide todo
Cuando Pandoc escribe un archivo docx, no copia el diseño de tu Markdown. Genera un documento nuevo y asigna estilos con nombre a cada elemento: Heading 1 para las secciones de primer nivel, Body Text para los párrafos normales, Table Caption para las leyendas de tablas. Word decide entonces cómo se ven esos estilos — y las definiciones proceden del reference docx que proporcionaste.
El contenido del archivo de referencia en sí se ignora. Solo importan sus estilos y sus propiedades de documento: tamaño de página, márgenes, encabezado y pie, incluso el idioma predeterminado. Esa separación es lo que hace estable al sistema. Nunca editas a mano la salida generada; editas la plantilla una vez, y cada conversión futura recoge el cambio automáticamente.
Cómo producir tu primera plantilla
Hay dos puntos de partida prácticos. El primero es dejar que Pandoc imprima su propia plantilla predeterminada: ejecuta pandoc con el argumento --print-default-data-file reference.docx y guarda la salida en un archivo como custom-reference.docx. Ábrelo en Word, modifica los estilos que te interesan y guarda. Como partes del propio archivo de Pandoc, todos los estilos que el writer puede usar ya están presentes y bien nombrados.
La segunda ruta parte de una salida real. Convierte primero un documento Markdown representativo a docx, abre el resultado y reestilízalo directamente. Así no te engañas, porque editas exactamente la estructura que verán tus lectores, incluidas las peculiaridades de tu contenido real y no una muestra abstracta.
Los estilos que más importan
Empieza por la escalera de títulos. De Heading 1 a Heading 6 marcan el tono de todo el documento, así que ajusta ahí primero fuente, tamaño, espaciado y numeración. Title, Subtitle, Author y Date estilizan el bloque de título que aparece cuando tu Markdown lleva YAML front matter con esos campos. Body Text gobierna los párrafos normales, y First Paragraph te permite tratar de otra forma el párrafo que sigue a un título — un truco tipográfico habitual para quitar la sangría.
No pases por alto Compact, el estilo que Pandoc aplica a las listas compactas. Si tus listas se ven apretadas o demasiado espaciadas, ese es el estilo que hay que corregir. Configurar estos pocos estilos cubre la mayor parte de lo que un lector percibe en cualquier página, y ninguno exige tocar los diálogos más exóticos de Word.
Tablas, notas al pie y leyendas
Las tablas se estilizan mediante el estilo Table, que controla bordes, relleno de celdas y sombreado de la fila de encabezado. El editor de estilos de tabla de Word es quisquilloso, así que espera pasar aquí más tiempo que con los títulos. La recompensa es que cada tabla convertida hereda reglas coherentes en lugar de los valores desnudos con los que viene el writer.
Footnote Text controla el cuerpo de la nota al final de la página, mientras que Footnote Reference estiliza la marca en superíndice dentro del texto. Image Caption y Table Caption gestionan las leyendas que Pandoc adjunta a figuras y tablas respectivamente. Estilízalos una vez y los documentos largos se mantienen coherentes del primer capítulo al último apéndice.
Bloques de código y fórmulas
Los bloques de código caen en el estilo Source Code, y el código en línea se envuelve en Verbatim Char. Dale a Source Code una fuente monoespaciada, un sombreado de fondo claro y un interlineado razonable, y los documentos técnicos parecerán intencionados al instante. Los colores del resaltado de sintaxis, cuando están activados, se aplican sobre el estilo, así que el formato base sobrevive a cualquier tema de resaltado.
Las fórmulas siguen un camino totalmente distinto. Pandoc convierte la notación TeX al formato de ecuaciones nativo de Word, OMML, así que las fórmulas llegan como ecuaciones reales y editables, no como imágenes. Su apariencia sigue la fuente matemática del documento, que Word deja por defecto en Cambria Math. Rara vez necesitas reestilizar nada aquí; solo ten en cuenta que las ecuaciones viven fuera del sistema de estilos de párrafo.
Usar tu plantilla y cerrar el ciclo
En la línea de comandos todo el ciclo es un solo flag: pandoc --reference-doc=custom-reference.docx input.md -o output.docx. La exportación de Markdown a Word de este sitio se apoya por ahora en los estilos integrados de Pandoc, y su opción de plantilla Pro acepta una plantilla de texto de Pandoc para salida en Markdown, HTML, RST y LaTeX — así que para docx con marca, el reference docx más el flag de CLI es hoy el camino fiable.
Convierte las pruebas en un ciclo, no en un evento. Edita uno o dos estilos, reconvierte el mismo documento de muestra y compara con la salida anterior. Iterar con un archivo pequeño y representativo — dos niveles de título, una tabla, una nota al pie y un bloque de código — saca los problemas a la luz en segundos y te evita reestilizar a ciegas.
Entregar la plantilla a editores y editoriales
El reference docx terminado es un artefacto pequeño y autocontenido que codifica toda tu identidad visual: fuentes, márgenes, encabezados, pies, colores de títulos. Guárdalo junto a tu contenido en el control de versiones, dale un nombre claro, y cualquier miembro del equipo podrá regenerar archivos Word fieles a la marca desde Markdown sin tocar los diálogos de estilos de Word.
Los editores y las editoriales también se benefician, porque el documento llega con estilos con nombre reales en lugar de formato directo, de modo que sus propias plantillas pueden reasignar o sobrescribir cualquier cosa más adelante. Una única fuente Markdown y un archivo de plantilla pueden servir entonces a un sitio web, a un flujo de PDF y a una entrega en Word sin reformatear a mano.