@imontene/mdrender 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Cambios
 
+## 2.6.0 — 2026-10-22
+
+- **Marcas de agua** con el degradado Anti-Gravity, solo en el PDF y desactivadas por defecto:
+  - `--watermark <texto>` (o `watermark:`): texto en diagonal en cada página, ajustado al
+    tamaño y la orientación de la hoja;
+  - `--watermark-field` (o `watermarkField: true`): campo de luz en la esquina de cada página.
+
+  Van detrás del contenido y funcionan con cualquier tema.
+
 ## 2.5.0 — 2026-10-22
 
 - **Nuevo estilo por defecto: Anti-Gravity**, tomado del design system del mismo nombre y

package/README.md

@@ -156,6 +156,8 @@ equipo); `--port` fija el puerto y `--no-open` no abre el navegador.
 | `--no-page-numbers`            | Sin el pie con números de página                                                                 | —                     |
 | `--font <manrope\|inter>`      | Tipografía del texto (ver abajo)                                                                 | `manrope`             |
 | `--no-justify`                 | Párrafos alineados a la izquierda en el PDF (ver abajo)                                          | justificado           |
+| `--watermark <texto>`          | Marca de agua en diagonal en cada página del PDF, con el degradado Anti-Gravity                  | —                     |
+| `--watermark-field`            | Campo de luz con el degradado en la esquina 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`         |
@@ -195,6 +197,20 @@ 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.
 
+**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:
+
+```bash
+mdrender informe.md --watermark "Borrador"     # texto en diagonal en cada página
+mdrender informe.md --watermark-field          # campo de luz en la esquina de cada página
+```
+
+También como `watermark: Borrador` y `watermarkField: true` en el front matter o en
+`mdrender.config.json`. Van muy tenues y detrás del contenido: no tapan el texto, y las
+imágenes, tablas y tarjetas quedan por encima. Según la versión de Chrome, el texto de la marca
+puede formar parte del texto del PDF (aparecer al copiar o buscar). Funcionan con cualquier tema
+y son algo más intensas en los oscuros.
+
 **Tipografía**: el texto usa [Manrope](https://fonts.google.com/specimen/Manrope);
 `--font inter` (o `font: inter` en el front matter o en `mdrender.config.json`) vuelve a
 [Inter](https://fonts.google.com/specimen/Inter), la tipografía de las versiones anteriores.

package/dist/cli.js

@@ -27,6 +27,8 @@ const DOCUMENT_FLAGS = [
     "pageNumbers",
     "font",
     "justify",
+    "watermark",
+    "watermarkField",
     "density",
     "fontSize",
     "css",
@@ -63,6 +65,8 @@ function addDocumentOptions(command) {
         .option("--no-page-numbers", "no default page-number footer")
         .option("--font <font>", "text typeface: manrope or inter (default: manrope)")
         .option("--no-justify", "align paragraphs left in the PDF instead of justifying them")
+        .option("--watermark <text>", "text across every PDF page, in the Anti-Gravity gradient")
+        .option("--watermark-field", "a soft field of light in the corner 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 " +

package/dist/convert.js

@@ -14,6 +14,7 @@ import { fillMermaid, renderMermaid } from "./render/mermaid.js";
 import { SMALL_SCALE } from "./render/mermaid-fit.js";
 import { headerFooterStyle, mermaidThemeVariables } from "./render/antigravity.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 { writeFileAtomic } from "./write.js";
@@ -113,6 +114,17 @@ function layoutCss(options, margin) {
         rules.push(`html { font-size: ${options.fontSize}; }`);
     return rules.join("\n");
 }
+/** The watermarks asked for (PDF only), sized to the page's text area. */
+function watermarks(options, margin) {
+    const landscape = options.orientation === "landscape";
+    return watermarkHtml({
+        text: options.watermark,
+        field: options.watermarkField,
+        widthPx: textWidthPx(options.pageSize, landscape, margin),
+        heightPx: contentHeightPx(options.pageSize, landscape, margin),
+        dark: isDarkTheme(options.theme),
+    });
+}
 const fixed2 = (n) => n.toFixed(2);
 /** "Mermaid autofit: wrap 300, turned LR→TB, scale 0.33 → 1.00, height 81 → 903 px". */
 export function describeLayout(layout) {
@@ -215,6 +227,7 @@ paged = false) {
             }
         });
     }
+    const watermark = paged ? watermarks(options, margin) : "";
     const html = buildHtmlDocument({
         title,
         body,
@@ -226,7 +239,12 @@ paged = false) {
         showTitle: options.title !== undefined,
         themeCss,
         font: options.font,
-        layoutCss: [...densityCss(options.density), layoutCss(options, margin)],
+        beforeBody: watermark || undefined,
+        layoutCss: [
+            ...densityCss(options.density),
+            layoutCss(options, margin),
+            ...(watermark ? [WATERMARK_CSS] : []),
+        ],
         extraCss,
     });
     diagnostics.sort((a, b) => (a.line ?? 0) - (b.line ?? 0));

package/dist/doctor.js

@@ -138,6 +138,8 @@ function settingsCheck(options) {
             `${m.left} (top right bottom left), ${options.font} ` +
             `${options.fontSize ?? DEFAULT_FONT_SIZE}, ${options.density} density, ` +
             `${options.justify ? "justified" : "ragged"} paragraphs, ` +
+            (options.watermark?.trim() ? `watermark "${options.watermark.trim()}", ` : "") +
+            (options.watermarkField ? "watermark field, " : "") +
             `language ${options.lang}, theme ` +
             path.basename(options.theme),
     };

package/dist/options.d.ts

@@ -49,6 +49,10 @@ export interface DocumentOptions {
     mermaidAutofit: boolean;
     /** Whether autofit may turn a flowchart to the other axis (LR ↔ TB) when it reads far better. */
     mermaidFlip: MermaidFlip;
+    /** Text set diagonally across every page of the PDF, in the Anti-Gravity gradient. */
+    watermark?: string;
+    /** A soft field of light (the Anti-Gravity gradient) in the corner of every PDF page. */
+    watermarkField: boolean;
     /** Justify paragraphs in the PDF (body, quotes, alerts), breaking long words with hyphens. */
     justify: boolean;
     /** Typeface of the text: Manrope or Inter (code is always JetBrains Mono). */

package/dist/options.js

@@ -22,6 +22,7 @@ export const DEFAULT_OPTIONS = {
     mermaidFlip: "auto",
     font: "manrope",
     justify: true,
+    watermarkField: false,
     density: "normal",
     theme: "antigravity",
     css: [],
@@ -122,6 +123,8 @@ const VALIDATORS = {
     mermaidFlip: oneOf(MERMAID_FLIPS),
     font: oneOf(TEXT_FONTS),
     justify: bool,
+    watermark: text,
+    watermarkField: bool,
     density: oneOf(DENSITIES),
     fontSize,
     theme: (value, describe, baseDir) => {

package/dist/render/template.d.ts

@@ -20,6 +20,8 @@ export interface DocumentParts {
     themeCss?: string[];
     /** Text font to embed. Defaults to Manrope. */
     font?: TextFont;
+    /** HTML placed before the document body (the watermarks). */
+    beforeBody?: string;
     /** Layout stylesheets (density, font size, page height), applied after the theme. */
     layoutCss?: string[];
     /** Extra stylesheet contents, applied after the theme and layout. */

package/dist/render/template.js

@@ -61,7 +61,7 @@ ${author ? `<meta name="author" content="${escapeHtml(author)}">\n` : ""}<title>
 ${styles.map((css) => `<style>\n${css}\n</style>`).join("\n")}
 </head>
 <body>
-<main class="markdown-body">
+${parts.beforeBody ? parts.beforeBody + "\n" : ""}<main class="markdown-body">
 ${parts.showTitle ? titleBlock(parts) + "\n" : ""}${body}
 </main>
 </body>

package/dist/render/watermark.d.ts

@@ -0,0 +1,24 @@
+export interface WatermarkOptions {
+    /** Text set across every page; undefined or blank for none. */
+    text?: string;
+    /** A field of light in the corner of every page. */
+    field: boolean;
+    /** Size of the text area in CSS px (the text runs along its diagonal). */
+    widthPx: number;
+    heightPx: number;
+    /** Dark page: the marks are a little stronger, as the design system's dark stage. */
+    dark: boolean;
+}
+/** Angle (degrees, counter-clockwise) and font size (px) that fit `text` on the diagonal. */
+export declare function diagonalText(text: string, widthPx: number, heightPx: number): {
+    angle: number;
+    fontSize: number;
+};
+/** HTML of the requested marks, to go before the document body; "" when none is requested. */
+export declare function watermarkHtml(options: WatermarkOptions): string;
+/**
+ * Print-only placement: fixed over the text area of every page, under the content (the body
+ * becomes a stacking layer above it). Hidden on screen. With the field on every page, the title
+ * block's own field (Anti-Gravity) is dropped so the first page does not get two.
+ */
+export declare const WATERMARK_CSS: string;

package/dist/render/watermark.js

@@ -0,0 +1,86 @@
+import { escapeHtml } from "../html.js";
+/**
+ * Watermarks in the Anti-Gravity gradient (field-blue → field-cyan → field-violet), PDF only:
+ * a text set diagonally across every page, and a soft field of light in the top-right corner of
+ * every page. Both sit behind the content. Chrome repeats a `position: fixed` element on every
+ * printed page, at the same place in the text area, so pagination is left alone.
+ */
+const FIELD = { blue: "#4f7cff", cyan: "#22c3e6", violet: "#8c6cf0" };
+/** Angle (degrees, counter-clockwise) and font size (px) that fit `text` on the diagonal. */
+export function diagonalText(text, widthPx, heightPx) {
+    const angle = (Math.atan2(heightPx, widthPx) * 180) / Math.PI;
+    const diagonal = Math.hypot(widthPx, heightPx);
+    // Manrope 600 capitals average about 0.68 em; the text takes ~70% of the diagonal.
+    const chars = Math.max(1, [...text].length);
+    const fontSize = Math.min(heightPx * 0.2, (diagonal * 0.7) / (chars * 0.68));
+    return { angle, fontSize: Math.round(fontSize) };
+}
+function textMark(text, widthPx, heightPx, dark) {
+    const { angle, fontSize } = diagonalText(text, widthPx, heightPx);
+    // HTML rather than SVG text: Chrome paints the SVG text of a fixed element on the first page
+    // only, while HTML is repeated on every page like the rest of the element.
+    return `<div class="mdr-watermark-text" style="opacity: ${dark ? 0.14 : 0.1}"><span style="font-size: ${fontSize}px; transform: rotate(${(-angle).toFixed(2)}deg)">${escapeHtml(text.toUpperCase())}</span></div>`;
+}
+function fieldMark(dark) {
+    // The same three lights as the title block's field (theme-antigravity.css), each fading out
+    // inside the box so no edge shows.
+    return `<div class="mdr-watermark-field" style="opacity: ${dark ? 0.22 : 0.16}"></div>`;
+}
+/** HTML of the requested marks, to go before the document body; "" when none is requested. */
+export function watermarkHtml(options) {
+    const text = options.text?.trim();
+    if (!text && !options.field)
+        return "";
+    const parts = [
+        options.field ? fieldMark(options.dark) : "",
+        text ? textMark(text, options.widthPx, options.heightPx, options.dark) : "",
+    ].filter(Boolean);
+    return `<div class="mdr-watermark" aria-hidden="true">\n${parts.join("\n")}\n</div>`;
+}
+/**
+ * Print-only placement: fixed over the text area of every page, under the content (the body
+ * becomes a stacking layer above it). Hidden on screen. With the field on every page, the title
+ * block's own field (Anti-Gravity) is dropped so the first page does not get two.
+ */
+export const WATERMARK_CSS = `.mdr-watermark { display: none; }
+@media print {
+  .mdr-watermark {
+    display: block;
+    position: fixed;
+    inset: 0;
+    z-index: 0;
+    pointer-events: none;
+  }
+  .markdown-body { position: relative; z-index: 1; }
+  .mdr-watermark-text {
+    position: absolute;
+    inset: 0;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+  .mdr-watermark-text span {
+    font-family: var(--font-text);
+    font-weight: 600;
+    letter-spacing: 0.02em;
+    line-height: 1;
+    white-space: nowrap;
+    color: transparent;
+    background: linear-gradient(90deg, ${FIELD.blue}, ${FIELD.cyan}, ${FIELD.violet});
+    -webkit-background-clip: text;
+    background-clip: text;
+  }
+  .mdr-watermark-field {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 40%;
+    height: 230px;
+    background:
+      radial-gradient(28% 38% at 58% 45%, ${FIELD.blue}, transparent),
+      radial-gradient(16% 26% at 78% 58%, ${FIELD.cyan}, transparent),
+      radial-gradient(25% 30% at 40% 32%, ${FIELD.violet}, transparent);
+  }
+  .mdr-watermark:has(.mdr-watermark-field) ~ .markdown-body .doc-header::before { display: none; }
+}`;
+//# sourceMappingURL=watermark.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imontene/mdrender",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "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",