@imontene/mdrender 2.7.0 → 2.8.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Cambios
 
+## 2.8.1 — 2026-10-29
+
+- Tema `academic_basic`: márgenes laterales de 8 mm (antes 16 mm), con más ancho para las dos
+  columnas. Los márgenes superior e inferior siguen en 18 mm.
+
+## 2.8.0 — 2026-10-28
+
+- **Tema académico** `--theme academic_basic` (o `theme: academic_basic`), con el aspecto de
+  un artículo de revista científica:
+  - texto en STIX Two Text (incrustada en el PDF) y títulos, leyendas y tablas en Inter;
+  - en el PDF, dos columnas justificadas con sangría de párrafo; el bloque de título, las
+    tablas, los diagramas y las figuras anchas ocupan las dos;
+  - imágenes solas como figuras numeradas («Fig. 1.») con el texto alternativo como leyenda,
+    y `#wide` al final de la ruta para que ocupen las dos columnas;
+  - tablas con tres líneas, sin rejilla;
+  - márgenes de 18 × 16 mm, texto de 9,5 pt e Inter por defecto.
+- **Bloque de título para artículos**, con cualquier tema: `kicker` (etiqueta sobre el título),
+  `affiliations` (numeradas), `abstract` y `keywords` en el front matter, y `^1,2^` en
+  `author` para las afiliaciones en superíndice.
+
 ## 2.7.0 — 2026-10-23
 
 - `--watermark-field` pone ahora dos campos de luz en cada página: arriba a la izquierda (antes

package/README.md

@@ -24,7 +24,7 @@ Ejemplo: [`examples/ejemplo.md`](examples/ejemplo.md) → [`examples/ejemplo.pdf
 - 🗂️ **Lotes**: varios archivos, carpetas completas o patrones `docs/**/*.md`.
 - 🔁 **`--watch`** y **vista previa en vivo** en el navegador.
 - 🎨 Estilo **Anti-Gravity** por defecto (con variante oscura), los temas clásicos **claro** y
-  **oscuro**, o tu propio CSS.
+  **oscuro**, el tema **académico** a dos columnas (`academic_basic`), o tu propio CSS.
 - 🔌 **Sin conexión**: todo va empaquetado; por defecto no descarga nada de internet.
 - 💻 **Windows 10/11 y Linux** (x64; arm64 en Linux), probado en ambos en cada cambio.
 
@@ -160,7 +160,7 @@ equipo); `--port` fija el puerto y `--no-open` no abre el navegador.
 | `--watermark-field`            | Campos de luz con el degradado arriba a la izquierda y abajo a la derecha de cada página del PDF | —                     |
 | `--density <densidad>`         | `normal` o `compact` (menos espacio entre líneas y bloques)                                      | `normal`              |
 | `--font-size <tamaño>`         | Tamaño del texto en `pt` o `px`, de 6 a 24 pt; p. ej. `10pt`                                     | `10.5pt`              |
-| `--theme <tema\|css>`          | `antigravity`, `antigravity-dark`, `light`, `dark` o un `.css` que reemplaza el tema (ver abajo) | `antigravity`         |
+| `--theme <tema\|css>`          | `antigravity`, `antigravity-dark`, `light`, `dark`, `academic_basic` o un `.css` (ver abajo)     | `antigravity`         |
 | `--css <archivo.css>`          | CSS adicional (se puede repetir)                                                                 | —                     |
 | `--mermaid-theme <tema>`       | `default`, `neutral`, `dark`, `forest`, `base`                                                   | el del tema de página |
 | `--mermaid-flip <auto\|never>` | Si el autoajuste puede girar un diagrama de flujo de eje (ver abajo)                             | `auto`                |
@@ -197,6 +197,28 @@ del mismo nombre y llevado de diapositivas a páginas:
 versiones anteriores y `--theme dark` su variante oscura. El design system pide texto alineado
 a la izquierda: con este tema, usa `--no-justify` si quieres seguirlo al pie de la letra.
 
+**Tema académico** (`--theme academic_basic`): el aspecto de un artículo de revista
+científica. Ejemplo: [`examples/articulo-academico.md`](examples/articulo-academico.md) →
+[`examples/articulo-academico.pdf`](examples/articulo-academico.pdf).
+
+- Texto en [STIX Two Text](https://www.stixfonts.org), la serifa de las fuentes STIX hechas
+  para publicaciones científicas; títulos, leyendas, tablas y etiquetas en Inter.
+- En el PDF, **dos columnas** justificadas, con sangría en lugar de espacio entre párrafos. El
+  bloque de título, las tablas, los diagramas Mermaid y las figuras anchas ocupan las dos.
+- Bloque de título con etiqueta sobre una línea de color (`kicker`), autores con afiliaciones
+  numeradas (`author` y `affiliations`), resumen en negrita (`abstract`) y palabras clave
+  (`keywords`); ver [Front matter](#front-matter-y-configuración).
+- Cada imagen sola en su párrafo es una **figura numerada**: el texto alternativo es la
+  leyenda, que se imprime como «**Fig. 1.** …». Termina la ruta en `#wide` para que ocupe las
+  dos columnas: `![Leyenda.](grafico.png#wide)`.
+- Tablas con tres líneas (arriba, bajo el encabezado y abajo), sin rejilla.
+- Por defecto: márgenes de 18 mm arriba y abajo y 8 mm a los lados, texto de 9,5 pt y
+  `font: inter`; cualquier opción los cambia.
+
+En el HTML se ve a una sola columna. Chrome no ubica las figuras arriba o abajo de la página
+como en LaTeX: quedan donde aparecen en el texto, y las que ocupan las dos columnas pueden
+dejar algo de espacio libre antes de ellas.
+
 **Marca de agua**: dos marcas con el degradado azul → cian → violeta del design system
 Anti-Gravity, cada una por separado y solo en el PDF:
 
@@ -275,6 +297,28 @@ header: "{title} | | {date}"
 Con `title` en el front matter se muestra un bloque de título (título, subtítulo, autor y
 fecha). Las rutas de `css` y `theme` son relativas al archivo donde aparecen.
 
+Para artículos, el bloque de título admite además estos campos (con cualquier tema; el tema
+académico es el que les da forma de revista):
+
+```markdown
+---
+theme: academic_basic
+kicker: Artículo de investigación
+title: Cinética de conversión catalítica a baja temperatura
+author: Ana Pérez^1^, Luis Gómez^1,2^
+affiliations:
+  - Departamento de Química, Universidad de Ejemplo.
+  - Instituto de Materiales Avanzados.
+abstract: >
+  Medimos la conversión de un sustrato modelo con dos catalizadores…
+keywords: [catálisis, cinética]
+---
+```
+
+`^1,2^` en `author` marca las afiliaciones en superíndice; el encabezado y el pie
+(`{author}`) y los metadatos del PDF muestran los nombres sin esas marcas. Los párrafos del
+resumen se separan con una línea en blanco.
+
 ## Ecuaciones y diagramas
 
 | Sintaxis                          | Resultado                               |
@@ -369,6 +413,6 @@ cambios: [CHANGELOG.md](CHANGELOG.md).
 
 ## Licencia
 
-[MIT](LICENSE). Manrope, Inter y JetBrains Mono se distribuyen bajo la
+[MIT](LICENSE). Manrope, Inter, JetBrains Mono y STIX Two Text se distribuyen bajo la
 [SIL Open Font License 1.1](https://openfontlicense.org); los ejecutables incluyen
 `THIRD-PARTY-NOTICES.txt` con las licencias de todos los componentes.

package/dist/assets/theme-academic-basic.css

@@ -0,0 +1,378 @@
+/*
+ * mdrender academic theme (academic_basic): loaded after theme.css. A research-journal page:
+ * STIX Two Text for the text, Inter for titles, captions and labels, two justified columns in
+ * the PDF with the title block, wide figures, tables and diagrams across both, and tables with
+ * three rules only. On screen (HTML) the same type in a single column.
+ */
+
+:root {
+  --font-serif: "STIX Two Text", "Inter", Georgia, serif;
+  --ac-ink: #141414;
+  --ac-ink-secondary: #3d3d3d;
+  --ac-ink-muted: #5c5c5c;
+  --ac-rule: #141414;
+  --ac-hairline: #c4c4c4;
+  --ac-surface: #f6f6f4;
+  --ac-accent: #9b1b1f;
+  --ac-link: #1d4e89;
+  --ac-column-gap: 6.5mm;
+
+  /* The variables theme.css is written with */
+  --color-text: var(--ac-ink);
+  --color-muted: var(--ac-ink-muted);
+  --color-heading: var(--ac-ink);
+  --color-link: var(--ac-link);
+  --color-border: var(--ac-hairline);
+  --color-subtle-bg: var(--ac-surface);
+  --color-accent: var(--ac-accent);
+  --color-bg: #ffffff;
+  --color-stripe: #ffffff;
+  --alert-note: var(--ac-ink-secondary);
+  --alert-tip: var(--ac-ink-secondary);
+  --alert-important: var(--ac-accent);
+  --alert-warning: #8a5d00;
+  --alert-caution: var(--ac-accent);
+}
+
+body {
+  font-family: var(--font-serif);
+  font-feature-settings: "kern", "liga";
+  line-height: 1.38;
+  counter-reset: figure;
+}
+
+.markdown-body {
+  max-width: 720px;
+}
+
+/* Titles, captions and labels: the sans (--font-text, Inter by default). */
+h1,
+h2,
+h3,
+.doc-kicker,
+.doc-title,
+.doc-meta,
+.doc-abstract-title,
+.doc-keywords,
+.figure figcaption,
+table,
+.toc,
+.markdown-alert-title {
+  font-family: var(--font-text);
+}
+
+/* Headings: small and bold, set apart by space rather than rules. */
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  letter-spacing: 0;
+  line-height: 1.25;
+  padding-bottom: 0;
+  border-bottom: 0;
+}
+
+h1 {
+  margin: 0 0 0.6em;
+  font-size: 2.1em;
+  font-weight: 700;
+  letter-spacing: -0.015em;
+  line-height: 1.12;
+}
+
+h2 {
+  margin: 1.3em 0 0.35em;
+  font-size: 1.05em;
+  font-weight: 700;
+}
+
+h3 {
+  margin: 1.1em 0 0.3em;
+  font-size: 1em;
+  font-weight: 600;
+  font-style: italic;
+}
+
+h4,
+h5,
+h6 {
+  margin: 1em 0 0.2em;
+  font-size: 1em;
+  font-weight: 400;
+  font-style: italic;
+}
+
+/* Paragraphs: no space between them, the first line of the next one indented. */
+.markdown-body > p {
+  margin: 0;
+}
+
+.markdown-body > p + p {
+  text-indent: 1.2em;
+}
+
+ul,
+ol,
+blockquote,
+pre,
+table,
+dl,
+.math-display {
+  margin: 0.6em 0;
+}
+
+ul,
+ol {
+  padding-left: 1.4em;
+}
+
+li + li {
+  margin-top: 0.15em;
+}
+
+strong {
+  font-weight: 700;
+}
+
+a {
+  color: var(--ac-link);
+}
+
+hr {
+  margin: 1.2em 0;
+  background: var(--ac-hairline);
+}
+
+blockquote {
+  padding: 0 0 0 0.9em;
+  color: var(--ac-ink-secondary);
+  border-left: 1.5px solid var(--ac-hairline);
+}
+
+/* Title block: kicker over a rule in the accent, title, authors, affiliations, abstract. */
+.doc-header {
+  margin-bottom: 1.4em;
+  padding-bottom: 1em;
+  border-bottom: 0.75pt solid var(--ac-rule);
+}
+
+.doc-kicker {
+  margin: 0 0 0.9em;
+  padding-top: 0.45em;
+  font-size: 0.78em;
+  font-weight: 700;
+  letter-spacing: 0.12em;
+  border-top: 2.5pt solid var(--ac-accent);
+}
+
+.doc-header .doc-title {
+  margin: 0 0 0.3em;
+  font-size: 2.3em;
+}
+
+.doc-subtitle {
+  margin: 0 0 0.7em;
+  font-size: 1.2em;
+  font-style: italic;
+  line-height: 1.3;
+  color: var(--ac-ink-secondary);
+}
+
+.doc-meta {
+  margin: 0.7em 0 0;
+  padding-bottom: 0;
+  font-size: 1.02em;
+  font-weight: 600;
+  color: var(--ac-ink);
+  border-bottom: 0;
+}
+
+.doc-meta sup,
+.doc-affiliations sup {
+  font-weight: 400;
+  font-size: 0.7em;
+}
+
+.doc-affiliations {
+  margin-top: 0.5em;
+  font-size: 0.82em;
+  line-height: 1.35;
+  color: var(--ac-ink-secondary);
+}
+
+.doc-abstract {
+  margin-top: 1.1em;
+}
+
+.doc-abstract-title {
+  margin-bottom: 0.35em;
+  font-size: 0.75em;
+  font-weight: 700;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: var(--ac-accent);
+}
+
+.doc-abstract p:not(.doc-abstract-title) {
+  margin: 0;
+  font-size: 1.08em;
+  font-weight: 700;
+  line-height: 1.38;
+}
+
+.doc-abstract p:not(.doc-abstract-title) + p {
+  margin-top: 0.4em;
+}
+
+.doc-keywords {
+  margin-top: 0.8em;
+  font-size: 0.8em;
+  color: var(--ac-ink-secondary);
+}
+
+.doc-keywords-label {
+  font-weight: 700;
+}
+
+/* Figures: "Fig. 1." in bold, the caption in the sans, aligned left. */
+.figure {
+  counter-increment: figure;
+  margin: 0.9em 0 1.1em;
+}
+
+.figure img {
+  width: auto;
+  max-width: 100%;
+}
+
+.figure figcaption {
+  margin-top: 0.55em;
+  font-size: 0.8em;
+  line-height: 1.35;
+  text-align: left;
+  color: var(--ac-ink);
+}
+
+.figure figcaption::before {
+  content: "Fig. " counter(figure) ". ";
+  font-weight: 700;
+}
+
+/* Tables: three rules (top, under the header, bottom), no grid and no stripes. */
+table {
+  width: 100%;
+  font-size: 0.82em;
+  line-height: 1.35;
+  border-top: 1.2pt solid var(--ac-rule);
+  border-bottom: 1.2pt solid var(--ac-rule);
+}
+
+th,
+td {
+  padding: 0.35em 0.6em;
+  border: 0;
+  text-align: left;
+}
+
+th {
+  font-weight: 700;
+  background: none;
+  border-bottom: 0.6pt solid var(--ac-rule);
+}
+
+tbody tr:nth-child(2n) {
+  background: none;
+}
+
+/* Code: quiet, no boxes around inline code. */
+code {
+  padding: 0;
+  font-size: 0.84em;
+  background: none;
+}
+
+pre {
+  font-size: 0.78em;
+  border: 0;
+  border-left: 1.5px solid var(--ac-hairline);
+  border-radius: 0;
+  background: var(--ac-surface);
+}
+
+/* Alerts: a rule and a small label, no cards. */
+.markdown-alert {
+  margin: 0.8em 0;
+  padding: 0.1em 0 0.1em 0.9em;
+  border-left-width: 1.5px;
+}
+
+.markdown-alert-title {
+  font-size: 0.75em;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+}
+
+.markdown-alert > p {
+  margin: 0 0 0.4em;
+}
+
+.toc {
+  padding: 0.8em 1em;
+  border: 0;
+  border-top: 0.75pt solid var(--ac-rule);
+  border-bottom: 0.75pt solid var(--ac-rule);
+  border-radius: 0;
+  background: none;
+  font-size: 0.9em;
+}
+
+/* Footnotes and references: small, after a short rule. */
+hr.footnotes-sep {
+  width: 30%;
+  margin: 1.6em 0 0.6em;
+  background: var(--ac-rule);
+}
+
+.footnotes {
+  font-size: 0.82em;
+  line-height: 1.35;
+  color: var(--ac-ink-secondary);
+}
+
+.footnotes-list {
+  padding-left: 1.6em;
+}
+
+.katex {
+  font-size: 1.05em;
+}
+
+/* The PDF: two columns. Spanning elements break the flow and balance the columns above them. */
+@media print {
+  .markdown-body {
+    columns: 2;
+    column-gap: var(--ac-column-gap);
+  }
+
+  .doc-header,
+  .markdown-body > h1,
+  .toc,
+  table,
+  .mermaid-diagram,
+  .figure-wide,
+  .keep-with-heading:has(.mermaid-diagram, .figure-wide) {
+    column-span: all;
+  }
+
+  /* Text-wide items keep some air from the columns around them. */
+  .markdown-body > h1,
+  .markdown-body > table,
+  .markdown-body > .mermaid-diagram,
+  .markdown-body > .figure-wide {
+    margin-top: 0.8em;
+    margin-bottom: 1.1em;
+  }
+}

package/dist/assets/theme-antigravity.css

@@ -112,6 +112,14 @@ h6 {
   color: var(--ag-accent);
 }
 
+.doc-header .doc-kicker {
+  order: -2;
+  font-family: var(--font-code);
+  font-size: 0.78em;
+  font-weight: 400;
+  letter-spacing: 0.14em;
+}
+
 .doc-header .doc-title {
   margin: 0 0 0.35em;
   font-size: 2.6em;

package/dist/assets/theme.css

@@ -494,6 +494,69 @@ div.math-error {
   border-bottom: 1px solid var(--color-border);
 }
 
+.doc-kicker {
+  margin: 0 0 0.5em;
+  font-size: 0.8em;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: var(--color-accent);
+}
+
+.doc-affiliations {
+  list-style: none;
+  margin: 0.6em 0 0;
+  padding: 0;
+  font-size: 0.85em;
+  color: var(--color-muted);
+}
+
+.doc-affiliations sup {
+  margin-right: 0.2em;
+}
+
+.doc-abstract {
+  margin: 1.2em 0 0;
+}
+
+.doc-abstract-title {
+  margin: 0 0 0.3em;
+  font-weight: 600;
+  color: var(--color-heading);
+}
+
+.doc-abstract p:not(.doc-abstract-title) {
+  margin: 0 0 0.6em;
+}
+
+.doc-keywords {
+  margin: 0.6em 0 0;
+  font-size: 0.9em;
+  color: var(--color-muted);
+}
+
+.doc-keywords-label {
+  font-weight: 600;
+}
+
+/* Figures (academic theme: a lone image with its alt text as caption) */
+.figure {
+  margin: 1.2em 0;
+  text-align: center;
+  break-inside: avoid;
+}
+
+.figure img {
+  display: block;
+  margin: 0 auto;
+}
+
+.figure figcaption {
+  margin-top: 0.5em;
+  font-size: 0.9em;
+  color: var(--color-muted);
+}
+
 /* Table of contents */
 .toc {
   margin: 0 0 2em;

package/dist/assets.d.ts

@@ -34,6 +34,8 @@ export declare const INTER_FACES: readonly [{
 /** Manrope faces in use (Fontsource, split into unicode-range subsets); it has no italics. */
 export declare const MANROPE_STYLESHEETS: string[];
 export declare const MONO_STYLESHEETS: string[];
+/** STIX Two Text, the serif text of the academic theme: regular and bold, each with its italic. */
+export declare const SERIF_STYLESHEETS: string[];
 export declare const KATEX_CSS = "katex/dist/katex.min.css";
 export declare const MERMAID_JS = "mermaid/dist/mermaid.min.js";
 export declare const THEMES: string[];

package/dist/assets.js

@@ -89,6 +89,13 @@ export const MONO_STYLESHEETS = [
     "@fontsource/jetbrains-mono/400-italic.css",
     "@fontsource/jetbrains-mono/700.css",
 ];
+/** STIX Two Text, the serif text of the academic theme: regular and bold, each with its italic. */
+export const SERIF_STYLESHEETS = [
+    "@fontsource/stix-two-text/400.css",
+    "@fontsource/stix-two-text/400-italic.css",
+    "@fontsource/stix-two-text/700.css",
+    "@fontsource/stix-two-text/700-italic.css",
+];
 export const KATEX_CSS = "katex/dist/katex.min.css";
 export const MERMAID_JS = "mermaid/dist/mermaid.min.js";
 export const THEMES = [
@@ -96,6 +103,7 @@ export const THEMES = [
     "mdrender/assets/theme-dark.css",
     "mdrender/assets/theme-antigravity.css",
     "mdrender/assets/theme-antigravity-dark.css",
+    "mdrender/assets/theme-academic-basic.css",
     "mdrender/assets/density-compact.css",
 ];
 export const PACKAGE_JSON = "mdrender/package.json";
@@ -111,7 +119,12 @@ export function assetManifest() {
     const keys = new Set([PACKAGE_JSON, ...THEMES, MERMAID_JS]);
     for (const { file } of INTER_FACES)
         keys.add(`${INTER_DIR}/${file}`);
-    for (const cssKey of [...MANROPE_STYLESHEETS, ...MONO_STYLESHEETS, KATEX_CSS]) {
+    for (const cssKey of [
+        ...MANROPE_STYLESHEETS,
+        ...MONO_STYLESHEETS,
+        ...SERIF_STYLESHEETS,
+        KATEX_CSS,
+    ]) {
         keys.add(cssKey);
         for (const font of woff2References(cssKey, readTextAsset(cssKey)))
             keys.add(font);

package/dist/cli.js

@@ -69,8 +69,8 @@ function addDocumentOptions(command) {
         .option("--watermark-field", "soft fields of light in the top-left and bottom-right corners of every PDF page")
         .option("--density <density>", "normal or compact (tighter spacing) (default: normal)")
         .option("--font-size <size>", "text size, e.g. 10pt or 11pt (default: 10.5pt)")
-        .option("--theme <theme>", "antigravity, antigravity-dark, light, dark, or a .css file replacing the theme " +
-        "(default: antigravity)")
+        .option("--theme <theme>", "antigravity, antigravity-dark, light, dark, academic_basic, or a .css file replacing " +
+        "the theme (default: antigravity)")
         .option("--css <file>", "extra stylesheet (repeatable)", collect)
         .option("--mermaid-theme <theme>", `Mermaid theme: ${MERMAID_THEMES.join(", ")} ` +
         "(default: the page theme's — base in Anti-Gravity colours, neutral for light, dark for dark)")

package/dist/convert.js

@@ -17,7 +17,7 @@ import { fieldImage } from "./render/field.js";
 import { FONT_FAMILIES, fontStack } from "./render/fonts.js";
 import { WATERMARK_CSS, watermarkHtml } from "./render/watermark.js";
 import { contentHeightPx, contentWidthPx, lengthToPx, textWidthPx } from "./render/page.js";
-import { buildHtmlDocument, builtinThemeCss, densityCss } from "./render/template.js";
+import { buildHtmlDocument, builtinThemeCss, densityCss, plainAuthor } from "./render/template.js";
 import { writeFileAtomic } from "./write.js";
 /** Starts one browser on first use and keeps it for later conversions. */
 export class BrowserPool {
@@ -176,6 +176,7 @@ paged = false) {
         lang: options.lang,
         // Soft hyphens only where paragraphs are justified: in the PDF.
         hyphenate: paged && options.justify ? options.lang : undefined,
+        figures: options.theme === "academic_basic",
     });
     const diagnostics = [
         ...config.warnings.map((message) => ({ severity: "warning", message })),
@@ -240,6 +241,10 @@ paged = false) {
         subtitle: options.subtitle,
         author: options.author,
         date: options.date,
+        kicker: options.kicker,
+        affiliations: options.affiliations,
+        abstract: options.abstract,
+        keywords: options.keywords,
         showTitle: options.title !== undefined,
         themeCss,
         font: options.font,
@@ -268,7 +273,8 @@ export async function convertFile(convert) {
         const { options } = doc;
         if (convert.format === "pdf") {
             const margin = resolveMargins(options);
-            const values = { title: doc.title, author: options.author, date: options.date };
+            const author = options.author === undefined ? undefined : plainAuthor(options.author);
+            const values = { title: doc.title, author, date: options.date };
             const footer = options.footer ?? (options.pageNumbers ? DEFAULT_FOOTER : undefined);
             const hasHeaderFooter = options.header !== undefined || footer !== undefined;
             doc.diagnostics.push(...headerFooterSpaceWarnings(margin, options.header !== undefined, footer !== undefined));

package/dist/i18n.d.ts

@@ -1,6 +1,9 @@
 export type AlertType = "note" | "tip" | "important" | "warning" | "caution";
 export interface Strings {
     toc: string;
+    /** Title-block labels (front matter `abstract` and `keywords`). */
+    abstract: string;
+    keywords: string;
     alerts: Record<AlertType, string>;
 }
 /** Default document language: Spanish. English and others are available with `lang`. */

package/dist/i18n.js

@@ -1,6 +1,8 @@
 const STRINGS = {
     en: {
         toc: "Contents",
+        abstract: "Abstract",
+        keywords: "Keywords",
         alerts: {
             note: "Note",
             tip: "Tip",
@@ -11,6 +13,8 @@ const STRINGS = {
     },
     es: {
         toc: "Contenido",
+        abstract: "Resumen",
+        keywords: "Palabras clave",
         alerts: {
             note: "Nota",
             tip: "Consejo",
@@ -21,6 +25,8 @@ const STRINGS = {
     },
     pt: {
         toc: "Sumário",
+        abstract: "Resumo",
+        keywords: "Palavras-chave",
         alerts: {
             note: "Nota",
             tip: "Dica",
@@ -31,6 +37,8 @@ const STRINGS = {
     },
     fr: {
         toc: "Sommaire",
+        abstract: "Résumé",
+        keywords: "Mots-clés",
         alerts: {
             note: "Remarque",
             tip: "Astuce",
@@ -41,6 +49,8 @@ const STRINGS = {
     },
     de: {
         toc: "Inhalt",
+        abstract: "Zusammenfassung",
+        keywords: "Schlüsselwörter",
         alerts: {
             note: "Hinweis",
             tip: "Tipp",

package/dist/markdown/env.d.ts

@@ -24,6 +24,8 @@ export interface RenderEnv extends Env {
     lang: string;
     /** Language whose hyphenation patterns break justified paragraphs (PDF only); see hyphenate.ts. */
     hyphenate?: string;
+    /** Render lone images as numbered figures captioned with their alt text (see figures.ts). */
+    figures?: boolean;
     /** Set when the document places its table of contents with a `[[toc]]` marker. */
     hasTocMarker: boolean;
 }

package/dist/markdown/figures.d.ts

@@ -0,0 +1,7 @@
+import type { MarkdownIt } from "markdown-it";
+/**
+ * With `env.figures` (the academic theme), a lone image becomes a numbered figure: its alt text
+ * is the caption, printed as "Fig. 1. …" by the theme. A `#wide` fragment on the image makes it
+ * span both columns.
+ */
+export declare function figures(md: MarkdownIt): void;

package/dist/markdown/figures.js

@@ -0,0 +1,53 @@
+/** Fragment that sets a figure across the full page width: `![…](plot.png#wide)`. */
+const WIDE = /#wide$/i;
+/** The image of a paragraph holding nothing but one image (`![caption](img.png)`). */
+function loneImage(tokens, i) {
+    if (tokens[i]?.type !== "paragraph_open" || tokens[i + 2]?.type !== "paragraph_close") {
+        return undefined;
+    }
+    const children = tokens[i + 1]?.children?.filter((child) => !(child.type === "text" && child.content.trim() === ""));
+    return children?.length === 1 && children[0].type === "image" ? children[0] : undefined;
+}
+/**
+ * With `env.figures` (the academic theme), a lone image becomes a numbered figure: its alt text
+ * is the caption, printed as "Fig. 1. …" by the theme. A `#wide` fragment on the image makes it
+ * span both columns.
+ */
+export function figures(md) {
+    md.core.ruler.push("figures", (state) => {
+        if (!state.env.figures)
+            return;
+        const tokens = state.tokens;
+        for (let i = 0; i < tokens.length; i++) {
+            const image = loneImage(tokens, i);
+            if (!image)
+                continue;
+            const src = String(image.attrGet("src") ?? "");
+            const wide = WIDE.test(src);
+            if (wide)
+                image.attrSet("src", src.replace(WIDE, ""));
+            tokens[i].meta = { ...tokens[i].meta, figure: { wide } };
+            tokens[i + 2].meta = { ...tokens[i + 2].meta, figure: { image } };
+            i += 2;
+        }
+    });
+    const open = md.renderer.rules.paragraph_open;
+    const close = md.renderer.rules.paragraph_close;
+    md.renderer.rules.paragraph_open = (tokens, idx, options, env, self) => {
+        const figure = tokens[idx].meta?.figure;
+        if (figure)
+            return `<figure class="figure${figure.wide ? " figure-wide" : ""}">\n`;
+        return open ? open(tokens, idx, options, env, self) : self.renderToken(tokens, idx, options);
+    };
+    md.renderer.rules.paragraph_close = (tokens, idx, options, env, self) => {
+        const figure = tokens[idx].meta?.figure;
+        if (!figure) {
+            return close
+                ? close(tokens, idx, options, env, self)
+                : self.renderToken(tokens, idx, options);
+        }
+        const caption = self.renderInline(figure.image.children ?? [], options, env).trim();
+        return `${caption ? `\n<figcaption>${caption}</figcaption>` : ""}\n</figure>\n`;
+    };
+}
+//# sourceMappingURL=figures.js.map

package/dist/markdown/index.d.ts

@@ -24,6 +24,8 @@ export interface MarkdownOptions {
     lang?: string;
     /** Insert soft hyphens in justified paragraphs, with this language's patterns. */
     hyphenate?: string;
+    /** Render lone images as numbered figures, captioned with their alt text. */
+    figures?: boolean;
 }
 export declare function createMarkdown(): MarkdownIt;
 export declare function renderMarkdown(source: string, options?: MarkdownOptions): MarkdownResult;

package/dist/markdown/index.js

@@ -6,6 +6,7 @@ import { DEFAULT_LANG } from "../i18n.js";
 import { alerts } from "./alerts.js";
 import { codeBlocks } from "./code-blocks.js";
 import { inlineChildLines } from "./env.js";
+import { figures } from "./figures.js";
 import { highlightCode } from "./highlight.js";
 import { hyphenation } from "./hyphenate.js";
 import { inlineLocalImages } from "./images.js";
@@ -28,6 +29,8 @@ export function createMarkdown() {
     md.use(tocMarker);
     md.use(keepWithHeading);
     md.use(inlineChildLines);
+    // Before images are embedded: it takes the #wide mark off their src.
+    md.use(figures);
     md.use(inlineLocalImages);
     // Before math and mermaid, which hand their non-code fences on to this renderer.
     md.use(codeBlocks);
@@ -49,6 +52,7 @@ export function renderMarkdown(source, options = {}) {
         lang: options.lang ?? DEFAULT_LANG,
         hasTocMarker: false,
         hyphenate: options.hyphenate,
+        figures: options.figures,
     };
     const tokens = md.parse(source, env);
     let title;

package/dist/options.d.ts

@@ -13,7 +13,7 @@ export declare const MERMAID_THEMES: readonly ["default", "neutral", "dark", "fo
 export type MermaidTheme = (typeof MERMAID_THEMES)[number];
 export declare const MERMAID_FLIPS: readonly ["auto", "never"];
 export type MermaidFlip = (typeof MERMAID_FLIPS)[number];
-export declare const BUILTIN_THEMES: readonly ["antigravity", "antigravity-dark", "light", "dark"];
+export declare const BUILTIN_THEMES: readonly ["antigravity", "antigravity-dark", "light", "dark", "academic_basic"];
 export type BuiltinTheme = (typeof BUILTIN_THEMES)[number];
 /** Built-in themes with a dark page. */
 export declare const isDarkTheme: (theme: string) => boolean;
@@ -69,10 +69,23 @@ export interface DocumentOptions {
     lang: string;
     title?: string;
     subtitle?: string;
+    /** Authors; `^1,2^` marks affiliation numbers as superscripts. */
     author?: string;
     date?: string;
+    /** Label above the title, e.g. "Research article". */
+    kicker?: string;
+    /** Affiliations, numbered 1, 2… under the authors. */
+    affiliations?: string[];
+    /** Summary shown under the title block (paragraphs separated by blank lines). */
+    abstract?: string;
+    keywords?: string[];
 }
 export declare const DEFAULT_OPTIONS: DocumentOptions;
+/**
+ * Defaults of a built-in theme, applied under every other layer: the academic theme sets its
+ * two columns in smaller type on wider margins, with Inter for titles, captions and labels.
+ */
+export declare const THEME_DEFAULTS: Partial<Record<BuiltinTheme, Partial<DocumentOptions>>>;
 export declare class OptionsError extends MdRenderError {
     constructor(message: string);
 }
@@ -95,6 +108,7 @@ label?: (key: string) => string): Partial<DocumentOptions>;
  * Merge option layers, later ones winning. CSS lists accumulate instead of replacing. A layer
  * that sets the `margin` shorthand also replaces single-side margins from earlier layers, so
  * `--margin 15mm` on the command line is not partly undone by `marginLeft` in a config file.
+ * The defaults of the chosen built-in theme (THEME_DEFAULTS) go under every layer.
  */
 export declare function mergeOptions(...layers: Partial<DocumentOptions>[]): DocumentOptions;
 /** The four page margins: the `margin` shorthand, with single-side options on top. */

package/dist/options.js

@@ -6,7 +6,13 @@ export const PAGE_SIZES = ["A3", "A4", "A5", "Letter", "Legal", "Tabloid"];
 export const ORIENTATIONS = ["portrait", "landscape"];
 export const MERMAID_THEMES = ["default", "neutral", "dark", "forest", "base"];
 export const MERMAID_FLIPS = ["auto", "never"];
-export const BUILTIN_THEMES = ["antigravity", "antigravity-dark", "light", "dark"];
+export const BUILTIN_THEMES = [
+    "antigravity",
+    "antigravity-dark",
+    "light",
+    "dark",
+    "academic_basic",
+];
 /** Built-in themes with a dark page. */
 export const isDarkTheme = (theme) => theme === "dark" || theme === "antigravity-dark";
 export const TEXT_FONTS = ["manrope", "inter"];
@@ -28,6 +34,13 @@ export const DEFAULT_OPTIONS = {
     css: [],
     lang: DEFAULT_LANG,
 };
+/**
+ * Defaults of a built-in theme, applied under every other layer: the academic theme sets its
+ * two columns in smaller type on wider margins, with Inter for titles, captions and labels.
+ */
+export const THEME_DEFAULTS = {
+    academic_basic: { margin: "18mm 8mm", fontSize: "9.5pt", font: "inter" },
+};
 export class OptionsError extends MdRenderError {
     constructor(message) {
         super(message, ExitCode.Usage);
@@ -63,6 +76,11 @@ const oneOf = (choices) => (value, describe) => {
         return match;
     throw new OptionsError(`${describe} must be one of: ${choices.join(", ")}`);
 };
+/** Text, or a list of texts (`keywords: [a, b]`). */
+const textList = (value, describe, baseDir) => {
+    const list = Array.isArray(value) ? value : [value];
+    return list.map((item) => text(item, describe, baseDir));
+};
 const length = (value, describe) => {
     const raw = text(value, describe, "");
     const trimmed = raw.trim();
@@ -147,6 +165,10 @@ const VALIDATORS = {
     subtitle: text,
     author: text,
     date: text,
+    kicker: text,
+    affiliations: textList,
+    abstract: text,
+    keywords: textList,
 };
 /**
  * Validate options from a config file, front matter or the command line.
@@ -180,10 +202,13 @@ const SIDES = ["marginTop", "marginRight", "marginBottom", "marginLeft"];
  * Merge option layers, later ones winning. CSS lists accumulate instead of replacing. A layer
  * that sets the `margin` shorthand also replaces single-side margins from earlier layers, so
  * `--margin 15mm` on the command line is not partly undone by `marginLeft` in a config file.
+ * The defaults of the chosen built-in theme (THEME_DEFAULTS) go under every layer.
  */
 export function mergeOptions(...layers) {
+    const theme = layers.reduce((t, layer) => layer.theme ?? t, DEFAULT_OPTIONS.theme);
+    const themeDefaults = THEME_DEFAULTS[theme];
     const merged = { ...DEFAULT_OPTIONS, css: [] };
-    for (const layer of layers) {
+    for (const layer of themeDefaults ? [themeDefaults, ...layers] : layers) {
         const { css, ...rest } = layer;
         if (rest.margin !== undefined)
             for (const side of SIDES)

package/dist/render/antigravity.js

@@ -77,6 +77,8 @@ export function mermaidThemeVariables(theme) {
 export function headerFooterStyle(theme) {
     if (isAntigravityTheme(theme))
         return { color: tokensFor(theme).inkMuted, mono: true };
+    if (theme === "academic_basic")
+        return { color: "#4a4a4a", mono: false };
     return { color: "#59636e", mono: false };
 }
 //# sourceMappingURL=antigravity.js.map

package/dist/render/fonts.d.ts

@@ -8,6 +8,8 @@ import type { TextFont } from "../options.js";
  * slants it) nor arrows and math symbols such as → ✓ ≤: those fall back to Inter, which is
  * embedded too in its regular and bold weights.
  * Code: JetBrains Mono from Fontsource (split into unicode-range subsets).
+ * Serif (academic theme only): STIX Two Text from Fontsource, the text face of the STIX fonts
+ * made for scientific publishing.
  */
 export declare const FONT_FAMILIES: Record<TextFont, string>;
 /** CSS font-family list for the text: the chosen font, Inter for missing glyphs, the system's. */
@@ -20,6 +22,8 @@ export declare function fontStack(font: TextFont): string;
 export declare function inlineFontStylesheet(cssKey: string): string;
 /** @font-face rules for every font a document uses, with the font files embedded. */
 export declare function fontFaceCss(font?: TextFont): string;
+/** @font-face rules for STIX Two Text, the academic theme's serif, with the files embedded. */
+export declare function serifFontFaceCss(): string;
 /** JetBrains Mono Regular alone, for page headers/footers set in the mono family. */
 export declare function monoRegularFontFace(): string;
 /** The text font's regular weight alone, for page headers/footers (rendered apart from the page). */

package/dist/render/fonts.js

@@ -1,4 +1,4 @@
-import { INTER_DIR, INTER_FACES, MANROPE_STYLESHEETS, MONO_STYLESHEETS, readAsset, readTextAsset, woff2References, } from "../assets.js";
+import { INTER_DIR, INTER_FACES, MANROPE_STYLESHEETS, MONO_STYLESHEETS, readAsset, SERIF_STYLESHEETS, readTextAsset, woff2References, } from "../assets.js";
 /**
  * Static (non-variable) font files are used on purpose: Chromium embeds variable fonts in PDFs
  * as Type 3 fonts, while static fonts are embedded as proper TrueType fonts.
@@ -8,6 +8,8 @@ import { INTER_DIR, INTER_FACES, MANROPE_STYLESHEETS, MONO_STYLESHEETS, readAsse
  * slants it) nor arrows and math symbols such as → ✓ ≤: those fall back to Inter, which is
  * embedded too in its regular and bold weights.
  * Code: JetBrains Mono from Fontsource (split into unicode-range subsets).
+ * Serif (academic theme only): STIX Two Text from Fontsource, the text face of the STIX fonts
+ * made for scientific publishing.
  */
 export const FONT_FAMILIES = { manrope: "Manrope", inter: "Inter" };
 /** CSS font-family list for the text: the chosen font, Inter for missing glyphs, the system's. */
@@ -64,6 +66,12 @@ export function fontFaceCss(font = "manrope") {
     }
     return css;
 }
+let serif;
+/** @font-face rules for STIX Two Text, the academic theme's serif, with the files embedded. */
+export function serifFontFaceCss() {
+    serif ??= SERIF_STYLESHEETS.map(inlineFontStylesheet).join("\n");
+    return serif;
+}
 let monoRegular;
 /** JetBrains Mono Regular alone, for page headers/footers set in the mono family. */
 export function monoRegularFontFace() {

package/dist/render/template.d.ts

@@ -1,7 +1,7 @@
 import { escapeHtml } from "../html.js";
 import type { BuiltinTheme, TextFont } from "../options.js";
 export { escapeHtml };
-/** Stylesheets of a built-in theme. */
+/** Stylesheets of a built-in theme, with the fonts it adds to the text and code ones. */
 export declare function builtinThemeCss(theme: BuiltinTheme): string[];
 /** Stylesheet for a density other than "normal", applied after the theme. */
 export declare function densityCss(density: "normal" | "compact"): string[];
@@ -13,8 +13,13 @@ export interface DocumentParts {
     lang?: string;
     /** Front matter metadata. With `showTitle`, rendered as a title block before the body. */
     subtitle?: string;
+    /** Authors; `^1,2^` marks affiliation numbers (superscripts in the title block). */
     author?: string;
     date?: string;
+    kicker?: string;
+    affiliations?: string[];
+    abstract?: string;
+    keywords?: string[];
     showTitle?: boolean;
     /** Theme stylesheet contents. Defaults to the built-in light theme. */
     themeCss?: string[];
@@ -27,5 +32,7 @@ export interface DocumentParts {
     /** Extra stylesheet contents, applied after the theme and layout. */
     extraCss?: string[];
 }
+/** The authors without their `^1,2^` affiliation marks, for metadata and page headers. */
+export declare const plainAuthor: (author: string) => string;
 /** Wrap a rendered Markdown fragment in a complete, self-contained HTML document. */
 export declare function buildHtmlDocument(parts: DocumentParts): string;

package/dist/render/template.js

@@ -1,6 +1,7 @@
 import { readTextAsset } from "../assets.js";
 import { escapeHtml } from "../html.js";
-import { fontFaceCss } from "./fonts.js";
+import { DEFAULT_LANG, strings } from "../i18n.js";
+import { fontFaceCss, serifFontFaceCss } from "./fonts.js";
 import { katexCss } from "./katex.js";
 import { version } from "../version.js";
 export { escapeHtml };
@@ -19,22 +20,53 @@ const THEME_FILES = {
     "antigravity-dark": ["theme.css", "theme-antigravity.css", "theme-antigravity-dark.css"],
     light: ["theme.css"],
     dark: ["theme.css", "theme-dark.css"],
+    academic_basic: ["theme.css", "theme-academic-basic.css"],
 };
-/** Stylesheets of a built-in theme. */
+/** Stylesheets of a built-in theme, with the fonts it adds to the text and code ones. */
 export function builtinThemeCss(theme) {
-    return THEME_FILES[theme].map(asset);
+    const css = THEME_FILES[theme].map(asset);
+    return theme === "academic_basic" ? [serifFontFaceCss(), ...css] : css;
 }
 /** Stylesheet for a density other than "normal", applied after the theme. */
 export function densityCss(density) {
     return density === "compact" ? [asset("density-compact.css")] : [];
 }
-function titleBlock({ title, subtitle, author, date }) {
-    const meta = [author, date].filter(Boolean).map((part) => escapeHtml(part));
+/** The authors without their `^1,2^` affiliation marks, for metadata and page headers. */
+export const plainAuthor = (author) => author.replace(/\^[^^\s][^^]*\^/g, "").trim();
+/** Escaped text with `^…^` turned into superscripts. */
+const withSuperscripts = (value) => escapeHtml(value).replace(/\^([^^\s][^^]*)\^/g, "<sup>$1</sup>");
+/** Paragraphs of a text, separated by blank lines. */
+const paragraphs = (value) => value
+    .split(/\n\s*\n/)
+    .map((p) => p.trim())
+    .filter(Boolean)
+    .map((p) => `<p>${escapeHtml(p)}</p>`);
+function titleBlock(parts) {
+    const { title, subtitle, author, date, kicker, affiliations = [], abstract, keywords = [], } = parts;
+    const labels = strings(parts.lang ?? DEFAULT_LANG);
+    const meta = [author ? withSuperscripts(author) : undefined, date ? escapeHtml(date) : undefined];
+    const metaText = meta.filter(Boolean).join(" · ");
     return [
         `<header class="doc-header">`,
+        kicker ? `<p class="doc-kicker">${escapeHtml(kicker)}</p>` : "",
         `<h1 class="doc-title">${escapeHtml(title)}</h1>`,
         subtitle ? `<p class="doc-subtitle">${escapeHtml(subtitle)}</p>` : "",
-        meta.length ? `<p class="doc-meta">${meta.join(" · ")}</p>` : "",
+        metaText ? `<p class="doc-meta">${metaText}</p>` : "",
+        affiliations.length
+            ? `<ol class="doc-affiliations">` +
+                affiliations.map((a, i) => `<li><sup>${i + 1}</sup>${escapeHtml(a)}</li>`).join("") +
+                `</ol>`
+            : "",
+        abstract
+            ? `<section class="doc-abstract">\n<p class="doc-abstract-title">${labels.abstract}</p>\n` +
+                paragraphs(abstract).join("\n") +
+                `\n</section>`
+            : "",
+        keywords.length
+            ? `<p class="doc-keywords"><span class="doc-keywords-label">${labels.keywords}:</span> ` +
+                keywords.map(escapeHtml).join(", ") +
+                `</p>`
+            : "",
         `</header>`,
     ]
         .filter(Boolean)
@@ -57,7 +89,7 @@ export function buildHtmlDocument(parts) {
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta name="generator" content="mdrender ${escapeHtml(version)}">
-${author ? `<meta name="author" content="${escapeHtml(author)}">\n` : ""}<title>${escapeHtml(title)}</title>
+${author ? `<meta name="author" content="${escapeHtml(plainAuthor(author))}">\n` : ""}<title>${escapeHtml(title)}</title>
 ${styles.map((css) => `<style>\n${css}\n</style>`).join("\n")}
 </head>
 <body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imontene/mdrender",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "Command-line app for Windows and Linux that renders Markdown — with LaTeX equations and Mermaid diagrams — to PDF and HTML set in Manrope or Inter",
   "keywords": [
     "markdown",
@@ -67,6 +67,7 @@
   "dependencies": {
     "@fontsource/jetbrains-mono": "^5.3.0",
     "@fontsource/manrope": "^5.3.0",
+    "@fontsource/stix-two-text": "^5.3.0",
     "@puppeteer/browsers": "^3.2.3",
     "chokidar": "^5.0.0",
     "commander": "^15.0.0",